Understanding how Jazz uses document site credentials
Mainsoft Document Collaboration for Rational Jazz saves login credentials for Document Sites on both the Rational Team Concert Client and on the Jazz Team Server. The two credentials are used for different purposes when working in Team Concert.
The client credentials are set by each user when trying to access the document library for the first time. Rational Team Concert uses these credentials to authenticate users when displaying and performing actions on document libraries in the Team Artifacts and Documents views. Client credentials are stored on the client computer and the Jazz Team Server administrator does not have access to them.

The server credentials are set when configuring the Related Document Workflow precondition. The Jazz Team Server uses these credentials to authenticate users when verifying the Related Document Workflow precondition when the user saves a work item. The scenario for triggering the use of the server credentials is:

The client credentials are set by each user when trying to access the document library for the first time. Rational Team Concert uses these credentials to authenticate users when displaying and performing actions on document libraries in the Team Artifacts and Documents views. Client credentials are stored on the client computer and the Jazz Team Server administrator does not have access to them.

The server credentials are set when configuring the Related Document Workflow precondition. The Jazz Team Server uses these credentials to authenticate users when verifying the Related Document Workflow precondition when the user saves a work item. The scenario for triggering the use of the server credentials is:

- The developer saves a work item with a new resolved state in Rational Team Concert.
- This triggers a precondition validation on the Jazz Team Server. If the work item has linked documents from document libraries defined as a Related Document Workflow precondition, the server uses the stored server credentials for the Document Site to verify the workflow or approval state of the documents.
- The documents’ workflow or approval states are returned to the Jazz Team Server from the Document Site.
- The Jazz Team Server saves the work item transition if the document workflow precondition is met, and the Rational Team Concert Client GUI is updated. If the precondition fails, an error message is displayed.
