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 ( |
Admin API key |
An Anthropic Admin API key ( |
Required only for |
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 | 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/connectorsdirectory, 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/connectorsdirectory 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
-
From the sidebar, click Provisioners.
-
On the Provisioners page, click New Provisioner.
-
In the New Provisioner modal, enter a Name.
-
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.
-
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
-
From the navigation bar, click Configure > Connectors.
-
On the Connectors page, click New Connector.
-
On the New Connector page, type a Connector Name.
-
From the Connector Type list, select Anthropic Connector - 1.5.20.39.
-
Complete the Base Connector Details and any applicable Additional Options.
For a list of all configuration properties, refer to Anthropic Connector Configuration. -
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 |
|---|---|---|
|
Yes |
Anthropic API key ( |
|
Conditional |
Anthropic Admin API key ( |
|
Conditional |
Advanced Identity Cloud OAuth2 token endpoint for hop 1 of the service account token exchange. |
|
Conditional |
OAuth2 client ID registered in Advanced Identity Cloud for the service account token exchange. |
|
Conditional |
RS256 private key (JWK) used to sign the client assertion for the Advanced Identity Cloud OAuth2 client. |
|
Conditional |
Anthropic federation rule ID used to exchange the Advanced Identity Cloud token for an Anthropic service account token. |
|
Conditional |
Anthropic organization ID, sent in the service account token exchange. |
|
Conditional |
Anthropic service account ID, sent in the service account token exchange. |
|
Optional |
Value sent in the |
|
Optional |
Value sent in the |
|
Optional |
OAuth2 scope requested in the Advanced Identity Cloud client credentials grant, for example |
|
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 |
|---|---|---|
|
|
|
|
|
|
|
Workload Identity Federation bearer token |
|
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:
-
The connector signs an RS256 client assertion with
aicClientPrivateKeyand exchanges it for a short-lived Advanced Identity Cloud access token ataicTokenEndpoint(client credentials grant with private key JWT authentication). -
The connector presents that token as a JWT bearer assertion to
POST /v1/oauth/tokenon the Anthropic API, together withfederationRuleId,organizationId, andserviceAccountId(andworkspaceIdwhen 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:
-
eqonUidreads a single object by its Uid, for every object class. -
eqonworkspaceIdscopesworkspace,workspaceMember, andapiKeyqueries 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 |
|---|---|
|
|
|
|
Rate limiting and errors
| Behavior | Description |
|---|---|
HTTP 429 |
The connector retries up to three times, honoring a numeric |
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 |
|---|---|---|---|
|
Claude Managed Agent |
|
Represents one managed agent, current version only. Uid is the agent ID. |
|
Organization workspace |
|
Uid is the workspace ID. |
|
Claude model |
|
Uid is the model ID. |
|
Workspace member |
|
Uid is the composite |
|
Organization API key |
|
Uid is the key ID. |
|
Derived agent tool |
|
Not a native Anthropic resource. Derived from the |
|
Organization service account |
|
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 |
|---|---|---|---|
|
String |
No |
Agent ID. Also the Uid. |
|
String |
No |
Agent name. |
|
String |
No |
Agent description. |
|
String |
No |
System prompt. |
|
String |
No |
Current agent version. |
|
String |
No |
ID of the underlying Claude model. |
|
String |
No |
Model speed selection. |
|
String |
No |
Creation timestamp. |
|
String |
No |
Last update timestamp. |
|
String |
No |
Archival timestamp. |
|
String |
No |
MCP server configuration as a raw JSON string. |
|
String |
No |
Agent metadata as a raw JSON string. |
|
String |
No |
Agent skills as a raw JSON string. |
|
String |
No |
The agent’s |
|
String |
Yes |
Uids of the |
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 |
|---|---|---|---|
|
String |
No |
Workspace ID. Also the Uid. |
|
String |
No |
Workspace name. |
|
String |
No |
Creation timestamp. |
|
String |
No |
Archival timestamp. |
|
String |
No |
UI display color. |
|
String |
No |
Compartment the workspace belongs to. |
|
String |
No |
External key identifier. |
|
String |
No |
Workspace data residency geography. |
|
String |
No |
Geographies where inference is allowed. |
|
String |
No |
Default inference geography. |
|
String |
No |
Inference data retention policy. |
|
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 |
|---|---|---|---|
|
String |
No |
Model ID. Also the Uid. |
|
String |
No |
Human-readable model name. |
|
String |
No |
Release timestamp. |
|
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 |
|---|---|---|---|
|
String |
No |
Parent workspace ID. |
|
String |
No |
Member user ID. |
|
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 |
|---|---|---|---|
|
String |
No |
API key ID. Also the Uid. |
|
String |
No |
Key name. |
|
String |
No |
Key status. |
|
String |
No |
Workspace the key belongs to. |
|
String |
No |
Creation timestamp. |
|
String |
No |
Expiry timestamp. |
|
String |
No |
Masked key hint for identification. |
|
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 |
|---|---|---|---|
|
String |
No |
Parent agent ID. |
|
String |
No |
Tool type. |
|
String |
No |
Custom tool name. Present on custom tools. |
|
String |
No |
MCP server the tool belongs to. Present on MCP tools. |
|
String |
No |
Whether the tool is enabled by default. |
|
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 |
|---|---|---|---|
|
String |
No |
Service account ID. Also the Uid. |
|
String |
No |
Service account name. |
|
String |
No |
Service account description. |
|
String |
No |
Role in the organization. |
|
String |
No |
Creation timestamp. |
|
String |
No |
ID of the actor that created the service account. |
|
String |
No |
Last update timestamp. |
|
String |
No |
ID of the actor that last updated the service account. |
|
String |
No |
Archival timestamp. |
|
String |
No |
ID of the actor that archived the service account. |
Troubleshooting
Connector initializes but test fails
Check:
-
The
apiKeyis a valid Anthropic API key (sk-ant-api...). -
The API key has access to the models endpoint.
-
anthropicVersionis set to a version the API accepts.
workspace, workspaceMember, or apiKey queries fail with an authorization error
Check:
-
adminApiKeyis configured. These object classes require the Admin API key; the connector raises an error when it’s missing. -
The Admin API key belongs to the target organization and can read the relevant resources.
serviceAccount queries fail
Check:
-
All six Workload Identity Federation properties are configured. The connector raises an error when any of the six is missing.
-
The Advanced Identity Cloud OAuth client allows private key JWT authentication, and
aicClientPrivateKeymatches its registered key. -
federationRuleId,organizationId, andserviceAccountIdrefer to existing Anthropic objects. -
workspaceIdis set when the federation rule is workspace-scoped.
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
connectorvariable 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) |
|---|---|---|---|---|
|
|
|
Yes |
Yes |
Anthropic API key (starts with sk-ant-api…). Used for models and Claude Managed Agents (agents and agent tools). |
||||
|
|
|
Yes |
|
Base URL of the Anthropic API, e.g. https://api.anthropic.com (no trailing slash). |
||||
|
|
|
|
No |
Value sent in the anthropic-version header, e.g. 2023-06-01. |
||||
|
|
|
Yes |
No |
Anthropic Admin API key (starts with sk-ant-admin…). Used for workspaces, workspace members, and organization API keys. |
||||
|
|
|
|
No |
Value sent in the anthropic-beta header on Claude Managed Agents calls, e.g. managed-agents-2026-04-01. |
||||
|
|
|
|
No |
Ping Advanced Identity Cloud OAuth2 token endpoint used for hop 1 of the service account Workload Identity Federation exchange. |
||||
|
|
|
|
No |
OAuth2 client id registered in Ping Advanced Identity Cloud for the Workload Identity Federation exchange. |
||||
|
|
|
Yes |
No |
RS256 private key (JWK) used to sign the private_key_jwt client assertion for the AIC OAuth2 client. |
||||
|
|
|
|
No |
OAuth2 scope requested in the AIC client credentials grant, e.g. fr:idm:*. |
||||
|
|
|
|
No |
To be used for debug/test purposes. To be avoided in production. |
||||
|
|
|
|
No |
Anthropic Workload Identity Federation rule id used to exchange the AIC token for an Anthropic service account token. |
||||
|
|
|
|
No |
To be used for debug/test purposes. To be avoided in production. |
||||
|
|
|
|
No |
Anthropic organization id, sent in the service account token exchange. |
||||
|
|
|
|
No |
Anthropic service account id, sent in the service account token exchange. |
||||
|
|
|
|
No |
Set this property to |
||||
|
|
|
|
No |
Default Anthropic workspace id; scopes the service account token exchange when the federation rule is workspace-scoped. |
||||
|
|
|
|
No |
Defines the max size of the HTTP connection pool used. |
||||
|
|
|
|
No |
Defines the Hostname if an HTTP proxy is used between the connector and the service. |
||||
|
|
|
|
No |
Defines the Port if an HTTP proxy is used between the connector and the service. |
||||
|
|
|
|
No |
Defines Proxy Username if an HTTP proxy is used between the connector and the service. |
||||
|
|
|
Yes |
No |
Defines Proxy Password if an HTTP proxy is used between the connector and the service. |
||||
|
|
|
|
No |
Defines a timeout for the underlying HTTP connection in seconds. |
||||
|
|
|
|
No |
The User Agent HTTP Header used by the connector. Defaults to |
||||
(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.