ICF 1.5.20.39

Anthropic connector

Anthropic is the company behind the Claude family of AI models and the Claude developer platform. The Anthropic connector is a read-only connector that discovers Claude Managed Agents (beta) and governance-relevant objects including workspaces, models, workspace members, API keys, agent tools, and service accounts.

The connector supports search, schema, and test operations only. It doesn’t create, update, or delete Anthropic resources.

Anthropic requirements

The connector uses three credential sets that aren’t interchangeable. Each one queries a different set of objects:

Requirement Value

API key

An Anthropic API key (sk-ant-api...). Queries models, Claude Managed Agents (agents), and agent tools.

Admin API key

An Anthropic Admin API key (sk-ant-admin...). Queries workspaces, workspace members, and organization API keys. The Admin API rejects the non-admin key, and the models endpoint rejects the Admin key.

Workload Identity Federation configuration

Required only for serviceAccount queries. An Advanced Identity Cloud OAuth client with private key JWT authentication, and an Anthropic federation rule ID, organization ID, and service account ID.

Install the Anthropic connector

To check for an Advanced Identity Cloud application for this connector, refer to:

You can download most connectors from Ping Identity Product Downloads, but some are included in the default deployment for Advanced Identity Cloud, IDM, or RCS. When using an included connector, you can skip installing it and move directly to configuration.

Connector included in default deployment
Connector IDM RCS

No

No

Download the connector .jar file from Ping Identity Product Downloads.

  • If you’re running the connector locally, place it in the /path/to/openidm/connectors directory, for example:

    mv ~/Downloads/anthropic-connector-1.5.20.39.jar /path/to/openidm/connectors/
  • If you’re using a remote connector server (RCS), place it in the /path/to/openicf/connectors directory on the RCS.

Configure the Anthropic connector

To create a connector configuration using a UI, use the Platform admin UI or the legacy admin UI (deprecated). Learn more about creating connector configuration.

Using the Platform admin UI

  1. From the sidebar, click settings_ethernet Provisioners.

  2. On the Provisioners page, click New Provisioner.

  3. In the New Provisioner modal, enter a Name.

  4. From the Connector Type list, select Anthropic Connector - 1.5.20.39.

    The UI displays a code editor field with the default provisioner configuration for the Anthropic connector.

  5. Make changes to the provisioner configuration, and click Save.

    For a list of all configuration properties, refer to Anthropic Connector Configuration.

When your connector is configured correctly, the connection status on the provisioner page displays as Connected.

Using the legacy admin UI

  1. From the navigation bar, click Configure > Connectors.

  2. On the Connectors page, click New Connector.

  3. On the New Connector page, type a Connector Name.

  4. From the Connector Type list, select Anthropic Connector - 1.5.20.39.

  5. Complete the Base Connector Details and any applicable Additional Options.

    For a list of all configuration properties, refer to Anthropic Connector Configuration.
  6. Click Save.

When your connector is configured correctly, the connector displays as Active in the legacy admin UI.

Connection details

The Anthropic connector uses the following connector-specific configuration properties. The Required column shows when each property applies.

For the complete property list, including inherited SaaS common properties such as proxy and TLS settings, refer to Anthropic Connector Configuration.
Property Required Description

apiKey

Yes

Anthropic API key (sk-ant-api...). Queries models, agents, and agent tools.

adminApiKey

Conditional

Anthropic Admin API key (sk-ant-admin...). Required to query workspace, workspaceMember, and apiKey.

aicTokenEndpoint

Conditional

Advanced Identity Cloud OAuth2 token endpoint for hop 1 of the service account token exchange.

aicClientId

Conditional

OAuth2 client ID registered in Advanced Identity Cloud for the service account token exchange.

aicClientPrivateKey

Conditional

RS256 private key (JWK) used to sign the client assertion for the Advanced Identity Cloud OAuth2 client.

federationRuleId

Conditional

Anthropic federation rule ID used to exchange the Advanced Identity Cloud token for an Anthropic service account token.

organizationId

Conditional

Anthropic organization ID, sent in the service account token exchange.

serviceAccountId

Conditional

Anthropic service account ID, sent in the service account token exchange.

anthropicVersion

Optional

Value sent in the anthropic-version header.

managedAgentsBetaVersion

Optional

Value sent in the anthropic-beta header on Claude Managed Agents calls.

aicScope

Optional

OAuth2 scope requested in the Advanced Identity Cloud client credentials grant, for example fr:idm:*.

workspaceId

Optional

Default Anthropic workspace ID. Scopes the service account token exchange when the federation rule is workspace-scoped.

The six Workload Identity Federation properties (aicTokenEndpoint, aicClientId, aicClientPrivateKey, federationRuleId, organizationId, and serviceAccountId) are required together. Configure all six to query serviceAccount; configure none for API-key-only deployments. aicScope and workspaceId are optional in both cases.

Example Anthropic configuration

{
  "connectorRef": {
    "bundleName": "org.forgerock.openicf.connectors.anthropic-connector",
    "bundleVersion": "[1.5.0.0,1.6.0.0)",
    "connectorName": "org.forgerock.openicf.connectors.anthropic.AnthropicConnector"
  },
  "configurationProperties": {
    "apiKey": {
      "$crypto": {
        "type": "x-simple-encryption",
        "value": {
          "cipher": "...",
          "data": "...",
          "iv": "...",
          "key": "openidm-sym-default"
        }
      }
    },
    "adminApiKey": {
      "$crypto": {
        "type": "x-simple-encryption",
        "value": {
          "cipher": "...",
          "data": "...",
          "iv": "...",
          "key": "openidm-sym-default"
        }
      }
    },
    "anthropicVersion": "2023-06-01",
    "managedAgentsBetaVersion": "managed-agents-2026-04-01"
  }
}

To query serviceAccount, add the Workload Identity Federation properties:

  "configurationProperties": {
    "apiKey": { ... },
    "adminApiKey": { ... },
    "anthropicVersion": "2023-06-01",
    "managedAgentsBetaVersion": "managed-agents-2026-04-01",
    "aicTokenEndpoint": "https://<tenant>.forgerock.io/am/oauth2/realms/root/access_token",
    "aicClientId": "<aic-client-id>",
    "aicClientPrivateKey": {
      "$crypto": {
        "type": "x-simple-encryption",
        "value": {
          "cipher": "...",
          "data": "...",
          "iv": "...",
          "key": "openidm-sym-default"
        }
      }
    },
    "aicScope": "fr:idm:*",
    "federationRuleId": "<federation-rule-id>",
    "organizationId": "<organization-id>",
    "serviceAccountId": "<service-account-id>",
    "workspaceId": "<workspace-id>"
  }

Test the Anthropic connector

Test that the configuration is correct by running the following command:

curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Accept-API-Version: resource=1.0" \
--request POST \
"http://localhost:8080/openidm/system/anthropic?_action=test"
{
  "name": "anthropic",
  "enabled": true,
  "config": "config/provisioner.openicf/anthropic",
  "connectorRef": {
    "bundleVersion": "[1.5.0.0,1.6.0.0)",
    "bundleName": "org.forgerock.openicf.connectors.anthropic-connector",
    "connectorName": "org.forgerock.openicf.connectors.anthropic.AnthropicConnector"
  },
  "displayName": "Anthropic Connector",
  "objectTypes": [
    "__ACCOUNT__",
    "workspace",
    "model",
    "workspaceMember",
    "apiKey",
    "agentTool",
    "serviceAccount",
    "__ALL__"
  ],
  "ok": true
}

If the command returns "ok": true, your connector has been configured correctly and can authenticate to the Anthropic API.

TestOp validates connectivity by calling GET /v1/models?limit=1 with the API key. It doesn’t validate the Admin API key or the Workload Identity Federation configuration. Verify Admin API queries and serviceAccount queries separately.

Anthropic remote connector

If you want to run this connector outside of PingOne Advanced Identity Cloud or IDM, you can configure the Anthropic connector as a remote connector. Java Connectors installed remotely on a Java Connector Server function identically to those bundled locally within PingOne Advanced Identity Cloud or installed locally on IDM.

Refer to Remote connectors for configuring the Anthropic remote connector.

Configure connection pooling

The Anthropic connector uses a non-poolable mechanism to manage connections. Learn more about the different pooling mechanisms in Connectors by pooling mechanism.

Implementation specifics

Credential routing

The connector sends one of three credential sets on every request, depending on the object class:

Object classes Credential Headers

__ACCOUNT__ (agents), agentTool, model

apiKey

x-api-key and anthropic-version, plus anthropic-beta for agents and agent tools

workspace, workspaceMember, apiKey

adminApiKey

x-api-key and anthropic-version

serviceAccount

Workload Identity Federation bearer token

Authorization: Bearer and anthropic-version; no x-api-key

Both API keys are rejected on the serviceAccount endpoints; only the bearer token authenticates there. The apiKey is also rejected on the Admin endpoints, and the adminApiKey is rejected on the models endpoint.

Service account authentication

The serviceAccount object class doesn’t use a static key. Anthropic rejects both API keys on the service accounts endpoint. Instead, the connector performs a two-hop Workload Identity Federation exchange:

  1. The connector signs an RS256 client assertion with aicClientPrivateKey and exchanges it for a short-lived Advanced Identity Cloud access token at aicTokenEndpoint (client credentials grant with private key JWT authentication).

  2. The connector presents that token as a JWT bearer assertion to POST /v1/oauth/token on the Anthropic API, together with federationRuleId, organizationId, and serviceAccountId (and workspaceId when the federation rule is workspace-scoped), and receives an Anthropic service account token (sk-ant-oat01-…​).

The connector caches the token on the shared configuration and renews it 60 seconds before it expires.

Search filters

The connector translates the equals (eq) filter only:

  • eq on Uid reads a single object by its Uid, for every object class.

  • eq on workspaceId scopes workspace, workspaceMember, and apiKey queries to one workspace.

The framework applies every other filter after the search completes.

Pagination

The connector pages internally and doesn’t honor a caller-supplied paging cookie:

Object classes Pagination scheme

workspace, model, apiKey, workspaceMember

after_id cursor with has_more

__ACCOUNT__ (agents), agentTool, serviceAccount

page cursor with next_page

Rate limiting and errors

Behavior Description

HTTP 429

The connector retries up to three times, honoring a numeric Retry-After header when present. When the retries are exhausted, the operation fails with a retryable exception so the framework can resubmit it.

HTTP 503 and 504

The connector surfaces a retryable exception.

HTTP 401 and 403

The connector surfaces an invalid credential or permission denied exception.

HTTP 404 on a Uid read

The search returns an empty result, not an error.

agentTool object class

agentTool is a synthetic object class. Anthropic exposes tools as an array on each agent, not as an independently addressable resource. The connector derives one agentTool object per entry in an agent’s tools array. The Uid is agentId:type[:mcpServerName], or agentId:custom:name for custom tools. Entries that would collide on Uid (duplicate names, duplicate servers, or a nameless custom tool) are logged and skipped.

Every agentTool query scans all agents because the Anthropic API has no agent-scoped tool filter. On large agent estates, query agentTool selectively.

Use the Anthropic connector

The Anthropic connector discovers the following resource types:

ICF Native Type Anthropic Resource Type Naming Attribute Notes

__ACCOUNT__

Claude Managed Agent

__NAME__

Represents one managed agent, current version only. Uid is the agent ID. __NAME__ is the agent name, falling back to the agent ID.

workspace

Organization workspace

__NAME__

Uid is the workspace ID.

model

Claude model

__NAME__

Uid is the model ID. __NAME__ is the display name, falling back to the model ID.

workspaceMember

Workspace member

__NAME__

Uid is the composite workspaceId:userId.

apiKey

Organization API key

__NAME__

Uid is the key ID.

agentTool

Derived agent tool

__NAME__

Not a native Anthropic resource. Derived from the tools array on each agent. Refer to agentTool object class.

serviceAccount

Organization service account

__NAME__

Requires the Workload Identity Federation configuration. Refer to Service account authentication.

__ACCOUNT__

Read agents
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/__ACCOUNT__?_queryFilter=true"
{
  "result": [
    {
      "_id": "agent_01ABCDEF1234567890",
      "agentId": "agent_01ABCDEF1234567890",
      "name": "invoice-triage-agent",
      "description": "Triages inbound invoices",
      "system": "You are an invoice triage assistant.",
      "version": "3",
      "modelId": "claude-sonnet-4-5",
      "modelSpeed": "standard",
      "createdAt": "2026-08-14T09:21:04Z",
      "updatedAt": "2026-09-30T15:47:11Z",
      "archivedAt": null,
      "mcpServers": "[{\"name\":\"confluence\",\"url\":\"https://mcp.example.com/confluence\"}]",
      "metadata": "{\"team\":\"finance\"}",
      "skills": "[\"invoice-processing\"]",
      "toolsJson": "[{\"type\":\"custom\",\"name\":\"lookup_invoice\"},{\"type\":\"mcp\",\"mcp_server_name\":\"confluence\"}]",
      "toolIds": [
        "agent_01ABCDEF1234567890:custom:lookup_invoice",
        "agent_01ABCDEF1234567890:mcp:confluence"
      ],
      "__NAME__": "invoice-triage-agent"
    },
    ...
    {
      "_id": "agent_01FEDCBA0987654321",
      "agentId": "agent_01FEDCBA0987654321",
      "name": "policy-summary-agent",
      "description": "Summarizes policy documents",
      "system": "You are a policy summary assistant.",
      "version": "1",
      "modelId": "claude-opus-4-1",
      "modelSpeed": "standard",
      "createdAt": "2026-09-02T11:05:52Z",
      "updatedAt": "2026-09-02T11:05:52Z",
      "archivedAt": null,
      "mcpServers": "[]",
      "metadata": "{}",
      "skills": "[]",
      "toolsJson": "[]",
      "toolIds": [],
      "__NAME__": "policy-summary-agent"
    }
  ],
  "resultCount": 2,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
Read a specific agent
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/__ACCOUNT__/agent_01ABCDEF1234567890"
{
  "_id": "agent_01ABCDEF1234567890",
  "agentId": "agent_01ABCDEF1234567890",
  "name": "invoice-triage-agent",
  "description": "Triages inbound invoices",
  "system": "You are an invoice triage assistant.",
  "version": "3",
  "modelId": "claude-sonnet-4-5",
  "modelSpeed": "standard",
  "createdAt": "2026-08-14T09:21:04Z",
  "updatedAt": "2026-09-30T15:47:11Z",
  "archivedAt": null,
  "mcpServers": "[{\"name\":\"confluence\",\"url\":\"https://mcp.example.com/confluence\"}]",
  "metadata": "{\"team\":\"finance\"}",
  "skills": "[\"invoice-processing\"]",
  "toolsJson": "[{\"type\":\"custom\",\"name\":\"lookup_invoice\"},{\"type\":\"mcp\",\"mcp_server_name\":\"confluence\"}]",
  "toolIds": [
    "agent_01ABCDEF1234567890:custom:lookup_invoice",
    "agent_01ABCDEF1234567890:mcp:confluence"
  ],
  "__NAME__": "invoice-triage-agent"
}

__ACCOUNT__ attributes

Attribute Type Multivalued Description

agentId

String

No

Agent ID. Also the Uid.

name

String

No

Agent name.

description

String

No

Agent description.

system

String

No

System prompt.

version

String

No

Current agent version.

modelId

String

No

ID of the underlying Claude model.

modelSpeed

String

No

Model speed selection.

createdAt

String

No

Creation timestamp.

updatedAt

String

No

Last update timestamp.

archivedAt

String

No

Archival timestamp.

mcpServers

String

No

MCP server configuration as a raw JSON string.

metadata

String

No

Agent metadata as a raw JSON string.

skills

String

No

Agent skills as a raw JSON string.

toolsJson

String

No

The agent’s tools array as a raw JSON string.

toolIds

String

Yes

Uids of the agentTool objects derived from the agent’s tools array.

workspace

Read workspaces
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/workspace?_queryFilter=true"
{
  "result": [
    {
      "_id": "ws_01ABCDEF1234567890",
      "workspaceId": "ws_01ABCDEF1234567890",
      "name": "Finance",
      "createdAt": "2026-07-01T08:00:00Z",
      "archivedAt": null,
      "displayColor": "#D97706",
      "compartmentId": null,
      "externalKeyId": null,
      "dataResidencyWorkspaceGeo": "us",
      "dataResidencyAllowedInferenceGeos": "us,ca",
      "dataResidencyDefaultInferenceGeo": "us",
      "inferenceDataRetentionType": "none",
      "tags": "[{\"name\":\"cost-center\",\"value\":\"4711\"}]",
      "__NAME__": "Finance"
    },
    ...
    {
      "_id": "ws_01FEDCBA0987654321",
      "workspaceId": "ws_01FEDCBA0987654321",
      "name": "Engineering",
      "createdAt": "2026-07-03T10:12:40Z",
      "archivedAt": null,
      "displayColor": "#2563EB",
      "compartmentId": null,
      "externalKeyId": null,
      "dataResidencyWorkspaceGeo": "us",
      "dataResidencyAllowedInferenceGeos": "us",
      "dataResidencyDefaultInferenceGeo": "us",
      "inferenceDataRetentionType": "none",
      "tags": "[]",
      "__NAME__": "Engineering"
    }
  ],
  "resultCount": 2,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
Read a specific workspace
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/workspace/ws_01ABCDEF1234567890"
{
  "_id": "ws_01ABCDEF1234567890",
  "workspaceId": "ws_01ABCDEF1234567890",
  "name": "Finance",
  "createdAt": "2026-07-01T08:00:00Z",
  "archivedAt": null,
  "displayColor": "#D97706",
  "compartmentId": null,
  "externalKeyId": null,
  "dataResidencyWorkspaceGeo": "us",
  "dataResidencyAllowedInferenceGeos": "us,ca",
  "dataResidencyDefaultInferenceGeo": "us",
  "inferenceDataRetentionType": "none",
  "tags": "[{\"name\":\"cost-center\",\"value\":\"4711\"}]",
  "__NAME__": "Finance"
}

workspace attributes

Attribute Type Multivalued Description

workspaceId

String

No

Workspace ID. Also the Uid.

name

String

No

Workspace name.

createdAt

String

No

Creation timestamp.

archivedAt

String

No

Archival timestamp.

displayColor

String

No

UI display color.

compartmentId

String

No

Compartment the workspace belongs to.

externalKeyId

String

No

External key identifier.

dataResidencyWorkspaceGeo

String

No

Workspace data residency geography.

dataResidencyAllowedInferenceGeos

String

No

Geographies where inference is allowed.

dataResidencyDefaultInferenceGeo

String

No

Default inference geography.

inferenceDataRetentionType

String

No

Inference data retention policy.

tags

String

No

Workspace tags as a raw JSON string.

model

Read models
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/model?_queryFilter=true"
{
  "result": [
    {
      "_id": "claude-sonnet-4-5",
      "modelId": "claude-sonnet-4-5",
      "displayName": "Claude Sonnet 4.5",
      "createdAt": "2025-09-29T00:00:00Z",
      "type": "model",
      "__NAME__": "Claude Sonnet 4.5"
    },
    ...
    {
      "_id": "claude-opus-4-1",
      "modelId": "claude-opus-4-1",
      "displayName": "Claude Opus 4.1",
      "createdAt": "2025-08-05T00:00:00Z",
      "type": "model",
      "__NAME__": "Claude Opus 4.1"
    }
  ],
  "resultCount": 2,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
Read a specific model
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/model/claude-sonnet-4-5"
{
  "_id": "claude-sonnet-4-5",
  "modelId": "claude-sonnet-4-5",
  "displayName": "Claude Sonnet 4.5",
  "createdAt": "2025-09-29T00:00:00Z",
  "type": "model",
  "__NAME__": "Claude Sonnet 4.5"
}

model attributes

Attribute Type Multivalued Description

modelId

String

No

Model ID. Also the Uid.

displayName

String

No

Human-readable model name.

createdAt

String

No

Release timestamp.

type

String

No

Model type.

workspaceMember

Read workspace members
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/workspaceMember?_queryFilter=true"
{
  "result": [
    {
      "_id": "ws_01ABCDEF1234567890:user_01AAAA",
      "workspaceId": "ws_01ABCDEF1234567890",
      "userId": "user_01AAAA",
      "role": "admin",
      "__NAME__": "ws_01ABCDEF1234567890:user_01AAAA"
    },
    ...
    {
      "_id": "ws_01ABCDEF1234567890:user_01BBBB",
      "workspaceId": "ws_01ABCDEF1234567890",
      "userId": "user_01BBBB",
      "role": "user",
      "__NAME__": "ws_01ABCDEF1234567890:user_01BBBB"
    }
  ],
  "resultCount": 2,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
Read a specific workspace member
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/workspaceMember/ws_01ABCDEF1234567890:user_01AAAA"
{
  "_id": "ws_01ABCDEF1234567890:user_01AAAA",
  "workspaceId": "ws_01ABCDEF1234567890",
  "userId": "user_01AAAA",
  "role": "admin",
  "__NAME__": "ws_01ABCDEF1234567890:user_01AAAA"
}

workspaceMember attributes

Attribute Type Multivalued Description

workspaceId

String

No

Parent workspace ID.

userId

String

No

Member user ID.

role

String

No

Member role in the workspace.

apiKey

Read API keys
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/apiKey?_queryFilter=true"
{
  "result": [
    {
      "_id": "key_01ABCDEF1234567890",
      "keyId": "key_01ABCDEF1234567890",
      "name": "finance-integration-key",
      "status": "active",
      "workspaceId": "ws_01ABCDEF1234567890",
      "createdAt": "2026-08-01T12:00:00Z",
      "expiresAt": null,
      "partialKeyHint": "sk-ant-api01-9f…​Zk",
      "createdBy": "user_01AAAA",
      "__NAME__": "finance-integration-key"
    },
    ...
    {
      "_id": "key_01FEDCBA0987654321",
      "keyId": "key_01FEDCBA0987654321",
      "name": "reporting-key",
      "status": "inactive",
      "workspaceId": "ws_01FEDCBA0987654321",
      "createdAt": "2026-06-11T09:30:00Z",
      "expiresAt": "2026-12-31T23:59:59Z",
      "partialKeyHint": "sk-ant-api01-2a…​Qm",
      "createdBy": "user_01BBBB",
      "__NAME__": "reporting-key"
    }
  ],
  "resultCount": 2,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
Read a specific API key
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/apiKey/key_01ABCDEF1234567890"
{
  "_id": "key_01ABCDEF1234567890",
  "keyId": "key_01ABCDEF1234567890",
  "name": "finance-integration-key",
  "status": "active",
  "workspaceId": "ws_01ABCDEF1234567890",
  "createdAt": "2026-08-01T12:00:00Z",
  "expiresAt": null,
  "partialKeyHint": "sk-ant-api01-9f…​Zk",
  "createdBy": "user_01AAAA",
  "__NAME__": "finance-integration-key"
}

apiKey attributes

Attribute Type Multivalued Description

keyId

String

No

API key ID. Also the Uid.

name

String

No

Key name.

status

String

No

Key status.

workspaceId

String

No

Workspace the key belongs to.

createdAt

String

No

Creation timestamp.

expiresAt

String

No

Expiry timestamp.

partialKeyHint

String

No

Masked key hint for identification.

createdBy

String

No

ID of the actor that created the key.

agentTool

Read agent tools
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/agentTool?_queryFilter=true"
{
  "result": [
    {
      "_id": "agent_01ABCDEF1234567890:custom:lookup_invoice",
      "agentId": "agent_01ABCDEF1234567890",
      "type": "custom",
      "name": "lookup_invoice",
      "mcpServerName": null,
      "defaultEnabled": "true",
      "defaultPermissionPolicy": "ask",
      "__NAME__": "agent_01ABCDEF1234567890:custom:lookup_invoice"
    },
    ...
    {
      "_id": "agent_01ABCDEF1234567890:mcp:confluence",
      "agentId": "agent_01ABCDEF1234567890",
      "type": "mcp",
      "name": null,
      "mcpServerName": "confluence",
      "defaultEnabled": "true",
      "defaultPermissionPolicy": "allowed",
      "__NAME__": "agent_01ABCDEF1234567890:mcp:confluence"
    }
  ],
  "resultCount": 2,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
Read a specific agent tool
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/agentTool/agent_01ABCDEF1234567890:custom:lookup_invoice"
{
  "_id": "agent_01ABCDEF1234567890:custom:lookup_invoice",
  "agentId": "agent_01ABCDEF1234567890",
  "type": "custom",
  "name": "lookup_invoice",
  "mcpServerName": null,
  "defaultEnabled": "true",
  "defaultPermissionPolicy": "ask",
  "__NAME__": "agent_01ABCDEF1234567890:custom:lookup_invoice"
}

agentTool attributes

Attribute Type Multivalued Description

agentId

String

No

Parent agent ID.

type

String

No

Tool type.

name

String

No

Custom tool name. Present on custom tools.

mcpServerName

String

No

MCP server the tool belongs to. Present on MCP tools.

defaultEnabled

String

No

Whether the tool is enabled by default.

defaultPermissionPolicy

String

No

Default permission policy.

serviceAccount

Read service accounts
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/serviceAccount?_queryFilter=true"
{
  "result": [
    {
      "_id": "sa_01ABCDEF1234567890",
      "serviceAccountId": "sa_01ABCDEF1234567890",
      "name": "recon-service-account",
      "description": "Service account used for reconciliation",
      "organizationRole": "admin",
      "createdAt": "2026-07-20T14:22:09Z",
      "createdByActorId": "user_01AAAA",
      "updatedAt": "2026-07-20T14:22:09Z",
      "updatedByActorId": "user_01AAAA",
      "archivedAt": null,
      "archivedByActorId": null,
      "__NAME__": "recon-service-account"
    },
    ...
    {
      "_id": "sa_01FEDCBA0987654321",
      "serviceAccountId": "sa_01FEDCBA0987654321",
      "name": "reporting-service-account",
      "description": "Service account used by reporting jobs",
      "organizationRole": "user",
      "createdAt": "2026-05-18T08:41:33Z",
      "createdByActorId": "user_01BBBB",
      "updatedAt": "2026-09-12T17:03:45Z",
      "updatedByActorId": "user_01BBBB",
      "archivedAt": null,
      "archivedByActorId": null,
      "__NAME__": "reporting-service-account"
    }
  ],
  "resultCount": 2,
  "pagedResultsCookie": null,
  "totalPagedResultsPolicy": "NONE",
  "totalPagedResults": -1,
  "remainingPagedResults": -1
}
Read a specific service account
curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Content-Type: application/json" \
--request GET \
"http://localhost:8080/openidm/system/anthropic/serviceAccount/sa_01ABCDEF1234567890"
{
  "_id": "sa_01ABCDEF1234567890",
  "serviceAccountId": "sa_01ABCDEF1234567890",
  "name": "recon-service-account",
  "description": "Service account used for reconciliation",
  "organizationRole": "admin",
  "createdAt": "2026-07-20T14:22:09Z",
  "createdByActorId": "user_01AAAA",
  "updatedAt": "2026-07-20T14:22:09Z",
  "updatedByActorId": "user_01AAAA",
  "archivedAt": null,
  "archivedByActorId": null,
  "__NAME__": "recon-service-account"
}

serviceAccount attributes

Attribute Type Multivalued Description

serviceAccountId

String

No

Service account ID. Also the Uid.

name

String

No

Service account name.

description

String

No

Service account description.

organizationRole

String

No

Role in the organization.

createdAt

String

No

Creation timestamp.

createdByActorId

String

No

ID of the actor that created the service account.

updatedAt

String

No

Last update timestamp.

updatedByActorId

String

No

ID of the actor that last updated the service account.

archivedAt

String

No

Archival timestamp.

archivedByActorId

String

No

ID of the actor that archived the service account.

Troubleshooting

Connector initializes but test fails

Check:

  1. The apiKey is a valid Anthropic API key (sk-ant-api...).

  2. The API key has access to the models endpoint.

  3. anthropicVersion is set to a version the API accepts.

workspace, workspaceMember, or apiKey queries fail with an authorization error

Check:

  1. adminApiKey is configured. These object classes require the Admin API key; the connector raises an error when it’s missing.

  2. The Admin API key belongs to the target organization and can read the relevant resources.

serviceAccount queries fail

Check:

  1. All six Workload Identity Federation properties are configured. The connector raises an error when any of the six is missing.

  2. The Advanced Identity Cloud OAuth client allows private key JWT authentication, and aicClientPrivateKey matches its registered key.

  3. federationRuleId, organizationId, and serviceAccountId refer to existing Anthropic objects.

  4. workspaceId is set when the federation rule is workspace-scoped.

Agents or agentTool return no records

Check:

  1. The API key can access the Claude Managed Agents beta.

  2. managedAgentsBetaVersion matches the beta version enabled for the tenant.

  3. The organization has managed agents.

OpenICF Interfaces Implemented by the Anthropic Connector

The Anthropic Connector implements the following OpenICF interfaces. For additional details, see ICF interfaces:

Schema

Describes the object types, operations, and options that the connector supports.

Script on Connector

Enables an application to run a script in the context of the connector.

Any script that runs on the connector has the following characteristics:

  • The script runs in the same execution environment as the connector and has access to all the classes to which the connector has access.

  • The script has access to a connector variable that is equivalent to an initialized instance of the connector. At a minimum, the script can access the connector configuration.

  • The script has access to any script arguments passed in by the application.

Search

Searches the target resource for all objects that match the specified object class and filter.

Test

Tests the connector configuration.

Testing a configuration checks all elements of the environment that are referred to by the configuration are available. For example, the connector might make a physical connection to a host that is specified in the configuration to verify that it exists and that the credentials that are specified in the configuration are valid.

This operation might need to connect to a resource, and, as such, might take some time. Do not invoke this operation too often, such as before every provisioning operation. The test operation is not intended to check that the connector is alive (that is, that its physical connection to the resource has not timed out).

You can invoke the test operation before a connector configuration has been validated.

Anthropic Connector Configuration

The Anthropic Connector has the following configurable properties:

Basic Configuration Properties

Property Type Default Encrypted(1) Required(2)

apiKey

GuardedString

null

Yes

Yes

Anthropic API key (starts with sk-ant-api…​). Used for models and Claude Managed Agents (agents and agent tools).

serviceUri

String

Yes

Base URL of the Anthropic API, e.g. https://api.anthropic.com (no trailing slash).

anthropicVersion

String

2023-06-01

No

Value sent in the anthropic-version header, e.g. 2023-06-01.

adminApiKey

GuardedString

null

Yes

No

Anthropic Admin API key (starts with sk-ant-admin…​). Used for workspaces, workspace members, and organization API keys.

managedAgentsBetaVersion

String

managed-agents-2026-04-01

No

Value sent in the anthropic-beta header on Claude Managed Agents calls, e.g. managed-agents-2026-04-01.

aicTokenEndpoint

String

null

No

Ping Advanced Identity Cloud OAuth2 token endpoint used for hop 1 of the service account Workload Identity Federation exchange.

aicClientId

String

null

No

OAuth2 client id registered in Ping Advanced Identity Cloud for the Workload Identity Federation exchange.

aicClientPrivateKey

GuardedString

null

Yes

No

RS256 private key (JWK) used to sign the private_key_jwt client assertion for the AIC OAuth2 client.

aicScope

String

null

No

OAuth2 scope requested in the AIC client credentials grant, e.g. fr:idm:*.

acceptSelfSignedCertificates

boolean

false

No

To be used for debug/test purposes. To be avoided in production.

federationRuleId

String

null

No

Anthropic Workload Identity Federation rule id used to exchange the AIC token for an Anthropic service account token.

disableHostNameVerifier

boolean

false

No

To be used for debug/test purposes. To be avoided in production.

organizationId

String

null

No

Anthropic organization id, sent in the service account token exchange.

serviceAccountId

String

null

No

Anthropic service account id, sent in the service account token exchange.

disableHttpCompression

boolean

false

No

Set this property to true to disable content compression.

workspaceId

String

null

No

Default Anthropic workspace id; scopes the service account token exchange when the federation rule is workspace-scoped.

maximumConnections

Integer

10

No

Defines the max size of the HTTP connection pool used.

httpProxyHost

String

null

No

Defines the Hostname if an HTTP proxy is used between the connector and the service.

httpProxyPort

Integer

null

No

Defines the Port if an HTTP proxy is used between the connector and the service.

httpProxyUsername

String

null

No

Defines Proxy Username if an HTTP proxy is used between the connector and the service.

httpProxyPassword

GuardedString

null

Yes

No

Defines Proxy Password if an HTTP proxy is used between the connector and the service.

connectionTimeout

int

30

No

Defines a timeout for the underlying HTTP connection in seconds.

userAgent

String

PingIdentityConnector

No

The User Agent HTTP Header used by the connector. Defaults to PingIdentityConnector.

(1) Whether the property value is considered confidential, and is therefore encrypted in IDM.

(2) A list of operations in this column indicates that the property is required for those operations.