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

CyberArk pode ser configurado como um provedor de credenciais de AgentCore identidade para acesso externo a recursos. Isso permite que seus agentes autentiquem usuários por meio CyberArk do serviço OAuth2 e obtenham tokens de acesso aos recursos da API. CyberArk 

## Saída
<a name="identity-idp-cyberark-outbound"></a>

**nota**  
AgentCore A identidade emite uma URL exclusiva de retorno de chamada do OAuth2 para cada provedor de credenciais que você cria. O URL de retorno de chamada exclusivo permite a vinculação de sessão, o que protege a troca do código de autorização do OAuth2 contra repetições e CSRF-style ataques entre provedores, garantindo que uma resposta de autorização só possa ser resgatada contra o provedor de credenciais específico que a iniciou. Como o URL é exclusivo por provedor, você não o saberá até **depois** de ligar`CreateOauth2CredentialProvider`. Crie seu cliente CyberArk OAuth2 primeiro e depois retorne ao console do CyberArk desenvolvedor para registrar o URL de retorno de chamada depois que o AgentCore Identity o emitir.

 **Etapa 1: criar o cliente CyberArk OAuth2** 

Use o procedimento a seguir para configurar um aplicativo CyberArk OpenID Connect e obter as credenciais de cliente necessárias para o Identity. AgentCore Você registrará o URI de redirecionamento na Etapa 3, depois que o AgentCore Identity emitir o URL de retorno de chamada exclusivo.

 **Para configurar um aplicativo CyberArk OAuth2** 

1. Abra o console do desenvolvedor para CyberArk.

1. Abra o **Identity Administration** e, em seguida, escolha **Web Apps**.

1. Abra a guia **Personalizado**.

1. Crie um aplicativo **OpenID Connect** personalizado.

1. Abra a página **Confiança**. Deixe o campo **URIs de redirecionamento autorizado** vazio por enquanto — você adicionará o URL de retorno de chamada exclusivo na Etapa 3.

1. Registre o ID do cliente e o segredo do cliente gerados, pois você precisará dessas informações para configurar o provedor de CyberArk recursos no AgentCore Identity.

1. Configure todos os escopos necessários para seu aplicativo.

1. Implante o aplicativo definindo as permissões apropriadas abrindo a página **Permissões** e adicionando as permissões relevantes.

Para obter mais detalhes, consulte a documentação [CyberArkdo OpenID Connect](https://docs.cyberark.com/identity/latest/en/content/applications/appscustom/openidaddconfigapp.htm).

 **Etapa 2: criar o provedor de credenciais de AgentCore identidade** 

Para configurar CyberArk como um provedor de recursos de saída, use o seguinte:

```
{
  "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"
    }
  }
}
```

A [CreateOauth2CredentialProvider](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateOauth2CredentialProvider.html)resposta inclui um `callbackUrl` campo. Esse URL é exclusivo desse provedor de credenciais e se parece com:`https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`. Salve esse valor para a próxima etapa.

 **Etapa 3: registre o URL de retorno de chamada exclusivo com CyberArk** 

Volte ao console do CyberArk desenvolvedor e adicione o URL de retorno de chamada exclusivo à lista de URI de redirecionamento do seu aplicativo OAuth2.

1. Faça login no console do CyberArk desenvolvedor e abra o aplicativo OAuth2 que você criou na Etapa 1.

1. Adicione o `callbackUrl` valor retornado por `CreateOauth2CredentialProvider` à configuração do URI de redirecionamento do aplicativo.

1. Salve as alterações.