Connecting to repositories and project areas
Users must create a connection from the client to a repository for access to project areas. Your Jazz® administrator must supply information to enable your access to the repository.
Before you begin
This topic assumes that your Jazz administrator has created a repository and a project area.
- The Uniform Resource Identifier (URI) for an existing repository.
Typically, this address is in the form of
http://hostname.example.com:9443/ccm, where you must substitute your own fully qualified host name and port number. Secure servers require the
https://protocol. The repository is created by a Jazz administrator, who must make it available on a local or network server.
- A user ID and password for the repository. Team member credentials are created on the web server and in team areas by Jazz administrators. Your administrator can configure the repository for user authentication in an LDAP directory.
with this section:
security.provider.1=com.ibm.jsse2.IBMJSSEProvider2 security.provider.2=com.ibm.crypto.provider.IBMJCE security.provider.3=com.ibm.security.jgss.IBMJGSSProvider security.provider.4=com.ibm.security.cert.IBMCertPath security.provider.5=com.ibm.security.sasl.IBMSASL security.provider.6=com.ibm.xml.crypto.IBMXMLCryptoProvider security.provider.7=com.ibm.xml.enc.IBMXMLEncProvider security.provider.8=org.apache.harmony.security.provider.PolicyProvider security.provider.9=com.ibm.security.jgss.mech.spnego.IBMSPNEGO
security.provider.1=com.ibm.security.capi.IBMCAC security.provider.2=com.ibm.jsse2.IBMJSSEProvider2 security.provider.3=com.ibm.crypto.provider.IBMJCE security.provider.4=com.ibm.security.jgss.IBMJGSSProvider security.provider.5=com.ibm.security.cert.IBMCertPath security.provider.6=com.ibm.security.sasl.IBMSASL security.provider.7=com.ibm.xml.crypto.IBMXMLCryptoProvider security.provider.8=com.ibm.xml.enc.IBMXMLEncProvider security.provider.9=org.apache.harmony.security.provider.PolicyProvider security.provider.10=com.ibm.security.jgss.mech.spnego.IBMSPNEGO
About this task
To access the required views and controls, open the Work Items perspective. Click .
To create a connection to a repository:
- If you have not previously created a repository connection, click the Create a Repository Connection link in the Team Artifacts view. Otherwise, right-click in the Team Artifacts view and click .
- In Create a Jazz Repository Connection window,
enter a Location URI. For example:
https://hostname.example.com:9443/ccm.The Location Name defaults to the server host name. You can modify it to simplify or clarify the name.
- In the Authentication section, the default Authentication Type is Username and Password. Enter the user name and password that your Jazz administrator has provided for you. Alternatively, you can select Smart Card or SSL Certificate as Authentication Type.
- Optional: To authenticate
using Kerberos/SPNEGO, complete the following steps:
Note: The Kerberos realm, Key distribution center, and Kerberos configuration file properties map to the java.security.krb5.realm, java.security.krb5.kdc, and java.security.krb5.conf system properties, respectively. For more information, see Jazz client configuration. The configuration option properties are global for your client, so if you have multiple repository connections, these properties are automatically shared. Changing the properties in one connection automatically changes them in any other Kerberos/SPNEGO connection. To apply a change to a configuration option that is already set, restart the client.
- In the Authentication Type field, select Kerberos/SPNEGO. If the client is configured with krb5.ini or krb5.conf in a default location, click Finish. Otherwise, set additional configuration options.
- To specify a Kerberos configuration file, expand Additional configuration options. In the Kerberos configuration file field, browse to the location of the file. The file can have any name.
- To specify a Kerberos realm name, host, and (optional) key distribution center port, complete the appropriate configuration fields.
- Click Finish.
- Optional: To log in using Windows credentials
that are the same as the credentials that you use to access the CCM
application, in the authentication field select Integrated
Windows Authentication. Note: You must be logged in to a workstation and authenticated by domain. You can use this authentication method instead of Kerberos/SPNEGO authentication if the Windows registry on a client machine does not have the required AllowTGTSessionKey=1 key. For more information about the AllowTGTSessionKey, see Providing a session key to the IBM JRE to enable Kerberos/SPNEGO SSO in ELM.
- Click Finish. The repository connection is displayed in the Team Artifacts Repository Connections folder.
- To open a project area, right-click the repository connection in the Team Artifacts view and click Manage Connected Project Areas.
- Select one or more project areas and click Finish.