Share this page

# Authentication using Common Access Cards

You can use Common Access Cards (CAC) to authenticate connections to Dimensions CM servers.

In this topic:

## Dimensions CAC protocol

Use the `dimensionscac` protocol:

dimensionscac://<servername>[:<port>]/<base database>@<connection>/<product>/<stream>[/<folder>]

Back to top

## Supported security providers

Operating system | Git Client version | Security provider
--- | --- | ---
Windows | 2.2 (and later) | ActivClient 7.1 ActivClient 7.0.2 hotfix 409
Linux | 2.3 (and later) | ActivClient 4.0 hotfix 1704011 OpenSC 0.17 (and later)

Back to top

## Using a CAC card

1. Insert a CAC card into the reader.
2. Run a `clone` command, for example:

   `git clone dimensionscac://myserver/cm_typical@dim14/qlarius/java_brancha_str .`

3. If promoted, enter the card’s PIN.
4. If there are multiple certificates on the card, select one.
5. The content is now cloned.

Back to top

## Changing the location of security provider libraries (v2.2)

The installer automatically detects your security provider installation and configures Git Client 2.2 to use it.

To manually configure the location of the library:

1. Edit this file: `%GIT_HOME%\mingw64\libexec\git-core\start-git-client`

   Note: The location of `start-git-client` on your system may be different.

2. Specify the name of the security provider: `export SECURITY_PROVIDER_NAME="ActivIdentity"`
3. Locate this line: `export ACTIV_PATH=`
4. Edit the path that points to the location of your security provider file: `export ACTIV_PATH=C:\Program Files\ActivIdentity\ActivClient\acpkcs211.dll`

Back to top

## Changing the location of security provider libraries (v2.3)

The installer automatically detects your security provider installation and configures Git Client 2.3 to use it.

To manually configure the location of the library:

1. Edit this file:

   - Windows: `%GIT_HOME%\mingw64\libexec\git-core\start-git-client`
   - UNIX, Linux, and MacOS: `/usr/libexec/git-core/start-git-client`

   Note: The location of `start-git-client` on your system may be different.

2. Specify the name of the security provider:
   - ActivClient: `export SECURITY_PROVIDER_NAME="ActivIdentity"`
   - OpenSC: `export SECURITY_PROVIDER_NAME="SunPKCS11-OpenSC"`
3. Locate this line: `export PKCS11_PATH=`
4. Edit the path that points to the location of your security provider file:

Operating system | Security provider | Example
--- | --- | ---
Windows | ActivClient | `export PKCS11_PATH=C:\Program Files\ActivIdentity\ActivClient\acpkcs211.dll`
Linux | ActivClient | `export PKCS11_PATH="/opt/hidglobal/ac.ac4linux.pkcs11/lib64/libac.pkcs220ong.so"`
OpenSC | `export PKCS11_PATH="/usr/lib/x86_64-linux-gnu/opensc-pkcs11.so"`

Back to top

## Changing the location of security provider libraries (v2.3.1.1)

The installer automatically detects your security provider installation and configures Git Client 2.3.1.1 to use it.

To manually configure the location of the library:

1. Edit this file:

   - Windows: `%GIT_HOME%\mingw64\libexec\git-core\setup-git-dm`
   - UNIX, Linux, and MacOS: `/usr/libexec/git-core/setup-git-dm`

   Note: The location of `setup-git-dm` on your system may be different.

2. Specify the name of the security provider:
   - ActivClient: `export SECURITY_PROVIDER_NAME="ActivIdentity"`
   - OpenSC: `export SECURITY_PROVIDER_NAME="SunPKCS11-OpenSC"`
3. Locate this line: `export PKCS11_PATH=`
4. Edit the path that points to the location of your security provider file:

Operating system | Security provider | Example
--- | --- | ---
Windows | ActivClient | `export PKCS11_PATH=C:\Program Files\ActivIdentity\ActivClient\acpkcs211.dll`
Linux | ActivClient | `export PKCS11_PATH="/opt/hidglobal/ac.ac4linux.pkcs11/lib64/libac.pkcs220ong.so"`
OpenSC | `export PKCS11_PATH="/usr/lib/x86_64-linux-gnu/opensc-pkcs11.so"`

https://admhelp.microfocus.com Dimensions CM 8942
Tips to improve your search results... Dimensions CM Help Center CM Help 14.6 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: