本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# CyberArk
<a name="identity-idp-cyberark"></a>

您可以將 CyberArk 設定為用於傳出資源存取的 AgentCore Identity 登入資料提供者。這可讓您的代理程式透過 CyberArk 的 OAuth2 服務驗證使用者，並取得 CyberArk API 資源的存取權杖。

## 傳出
<a name="identity-idp-cyberark-outbound"></a>

**注意**  
AgentCore Identity 會為您建立的每個登入資料提供者發出唯一的 OAuth2 回呼 URL。唯一的回呼 URL 可啟用工作階段繫結，透過確保授權回應只能針對啟動它的特定憑證提供者進行兌換，以保護 OAuth2 授權碼交換免受跨供應商重播和 CSRF 型攻擊。由於每個提供者的 URL 都是唯一的，因此在呼叫 **之前**，您都不會知道它`CreateOauth2CredentialProvider`。首先建立您的 CyberArk OAuth2 用戶端，然後返回 CyberArk 開發人員主控台，在 AgentCore Identity 發出回呼 URL 後註冊回呼 URL。

 **步驟 1：建立 CyberArk OAuth2 用戶端** 

使用下列程序來設定 CyberArk OpenID Connect 應用程式，並取得 AgentCore Identity 的必要用戶端憑證。在 AgentCore Identity 發出唯一的回呼 URL 之後，您將在步驟 3 中註冊重新導向 URI。

 **設定 CyberArk OAuth2 應用程式** 

1. 開啟 CyberArk 的開發人員主控台。

1. 開啟**身分管理**，然後選擇 **Web 應用程式**。

1. 開啟**自訂**索引標籤。

1. 建立自訂 **OpenID Connect** 應用程式。

1. 開啟**信任**頁面。現在將**授權重新導向 URIs** 欄位保留空白 — 您將在步驟 3 中新增唯一的回呼 URL。

1. 記錄產生的用戶端 ID 和用戶端秘密，因為您需要此資訊才能在 AgentCore Identity 中設定 CyberArk 資源提供者。

1. 設定應用程式所需的任何範圍。

1. 透過開啟許可****頁面並新增相關許可，設定適當的許可來部署應用程式。

如需詳細資訊，請參閱 [CyberArk 的 OpenID Connect 文件](https://docs.cyberark.com/identity/latest/en/content/applications/appscustom/openidaddconfigapp.htm)。

 **步驟 2：建立 AgentCore Identity 登入資料提供者** 

若要將 CyberArk 設定為傳出資源提供者，請使用下列項目：

```
{
  "name": "CyberArk",
  "credentialProviderVendor": "CyberArkOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret",
      "authorizationEndpoint": "https://your-tenant-id.id.cyberark.cloud/OAuth2/Authorize/__idaptive_cybr_user_oidc",
      "tokenEndpoint": "https://your-tenant-id.id.cyberark.cloud/OAuth2/Token/__idaptive_cybr_user_oidc",
      "issuer": "https://your-tenant-id.id.cyberark.cloud/__idaptive_cybr_user_oidc"
    }
  }
}
```

[CreateOauth2CredentialProvider](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateOauth2CredentialProvider.html) 回應包含 `callbackUrl` 欄位。此 URL 對此登入資料提供者是唯一的，如下所示：`https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`。儲存此值以供下一個步驟使用。

 **步驟 3：向 CyberArk 註冊唯一的回呼 URL** 

返回 CyberArk 開發人員主控台，並將唯一的回呼 URL 新增至 OAuth2 應用程式的重新導向 URI 清單。

1. 登入 CyberArk 開發人員主控台，並開啟您在步驟 1 中建立的 OAuth2 應用程式。

1. 將 傳回`callbackUrl`的值`CreateOauth2CredentialProvider`新增至應用程式的重新導向 URI 組態。

1. 儲存您的變更。