/
Finding the CAM Passport

Finding the CAM Passport

Finding the CAM Passport

When TM1 uses CAM (Cognos Access Manager) security, a CAM Passport is required for authentication. This article explains what a CAM Passport is and how to retrieve it for diagnostics or troubleshooting.

What Is a CAM Passport?

A CAM Passport is a security token issued by IBM Cognos that authenticates a user session. When Pulse connects to a TM1 instance running in Security Mode 3 (CAM security), it obtains a CAM Passport from the Cognos Dispatcher and includes it in all TM1 REST API requests.

CAM Passports expire after a period of inactivity. Pulse renews them automatically using the CAMKeepAliveInterval setting in Pulse.cfg.

How to Retrieve the CAM Passport

The CAM Passport for the current Pulse connection can be found via the Pulse REST API tool or by examining an active TM1 session.

Method 1 — Via the Pulse REST API Tool

  1. Enable the REST API Tool in Pulse.cfg:

    [WebServer] EnableRESTAPITool = true

  2. Restart the Pulse Application Server.

  3. Navigate to About → REST API Tool in the Pulse web client.

  4. Send a request to the TM1 sessions endpoint:

    GET /api/v1/Sessions

  5. The response will include the active session details. The CAM Passport is embedded in the session authentication header.

Method 2 — Via TM1 Architect / Perspectives

  1. Open TM1 Architect or Perspectives and connect to the TM1 instance using CAM credentials.

  2. Go to Server → Active Sessions.

  3. The CAM Passport is displayed in the session properties for the authenticated user.

Method 3 — Via TM1 REST API Directly

Send an authenticated request to the TM1 instance and inspect the Authorization header in the response:

GET https://<TM1Server>:<port>/api/v1/Sessions Authorization: CAMPassport <passport_value>

When Is This Needed?

You may need the CAM Passport when:

  • Debugging REST API calls to TM1 from external tools.

  • Troubleshooting CAM authentication failures where the exact passport value needs to be verified.

  • Working with Cubewise support to diagnose session or authentication issues.

Notes

  • CAM Passports are sensitive credentials — treat them like passwords and do not share them unnecessarily.

  • A CAM Passport is session-specific and time-limited. It cannot be reused across different sessions or after it expires.

  • Pulse automatically manages passport renewal — manual retrieval is only needed for diagnostic purposes.