To access project areas, you must create a connection from
the client to a repository. Your Jazz™ administrator
must supply the information that you need to access the repository.
Before you begin
Make sure that your Jazz administrator created a repository
and a project area.
You need the following information to connect
to a repository:
- The Uniform Resource Identifier (URI) for a repository. Typically,
this address is in the form of https://hostname.example.com:9443/ccm,
where you must substitute your own fully qualified host name and port
number. Secure servers are only supported and require the https://
protocol. The repository is created by a Jazz administrator, who must
make the repository available on a local or network server.
- A user ID and password for the repository. Jazz administrators
create team member credentials on the web server and in team areas.
Your administrator can configure the repository for user authentication
in an LDAP directory.
To use Smart Card authentication, you must enable the
IBM Common Access Card (CAC) provider within Java by editing the
install-directory/3rd
Party/jre/lib/security/java.security file.
Note: For the Rational® Team Concert Shell
on a 64-bit Windows platform, the Visual C++ 2010 32-bit redistributable
package must be installed.
Replace 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
with
this section:
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
Procedure
- In the Team Concert Shell Control Panel window,
click Create a Repository Connection.
Tip: For quick access, add the Team Concert Shell
Control Panel as a node on the Windows Explorer Navigation
pane. You can also create repository connections and connect to project
areas using the Managed Artifacts view.
- In Create a Jazz Repository Connection window,
enter a Location URI. For example: https://hostname.example.com:9443/ccm. The value of the location name defaults to the server
host name. If necessary, you can modify the name.
- In the Authentication section, type the user name and password
that your Jazz administrator provided.
- Optional: To authenticate
using Kerberos/SPNEGO, complete the following steps:
- 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.
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 Rational Team Concert Shell by logging
off and logging back in to the system.
- 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 CLM.
- Click OK. The repository
connection is displayed in the Team Artifacts window
under the Repository Connections folder.
- To connect to a project area, in the Get Connected
to a Jazz Repository window, click Connect to
Project Areas and complete the wizard.
Tip: To reconnect to a repository using the Rational Team Concert
Shell tray icon, right-click the icon; then click . If required, type the authentication information.