CyberArk PAM
Este documento fornece orientações sobre como integrar o CyberArk Privileged Access Manager (PAM) com o SOAR do Google Security Operations.
Versão da integração: 6.0
Antes de começar
Para configurar o CyberArk PAM para funcionar com a integração, tem de criar um utilizador para a integração e conceder a esse utilizador as autorizações para aceder aos cofres do CyberArk PAM necessários.
Crie um utilizador
Conclua os passos seguintes para criar um utilizador para a integração:
- Inicie sessão no PrivateArk Client como administrador.
- Aceda a Ferramentas > Ferramentas administrativas > Utilizadores e grupos.
- Na caixa de diálogo Utilizadores e grupos, selecione a localização do utilizador, clique em Novo e selecione Utilizador.
- Nos diferentes separadores da caixa de diálogo Novo utilizador, preencha as informações necessárias. Os separadores Geral e Autenticação são obrigatórios.
Para mais informações sobre como criar um utilizador, consulte o artigo Adicione um utilizador a um Vault.
Conceda autorizações ao utilizador criado
Conclua os passos seguintes para adicionar acesso a um cofre a um utilizador recém-criado:
- Inicie sessão no PrivateArk Client como administrador.
- Selecione o cofre ao qual quer conceder acesso e inicie sessão no mesmo (clique duas vezes).
- No menu superior, clique em Proprietários.
- Para adicionar um novo utilizador, clique em Adicionar.
- Na caixa de diálogo, selecione o utilizador.
- Na secção Autorizado a, selecione, pelo menos, as seguintes autorizações:
Monitor SafeRetrieve files from SafeStore files in SafeAdmisiter Safe
- Para guardar as alterações, clique em OK.
- Para sair da janela de diálogo, clique em Fechar.
Opcional: configure o certificado de cliente
Pode usar um certificado de cliente existente ou criar um novo para comunicações seguras entre a instância do CyberArk PAM e o Google SecOps SOAR. Para mais informações sobre como configurar o certificado de cliente, consulte a configuração do serviço Web do fornecedor de credenciais central.
Integre o CyberArk PAM e o Google SecOps
A integração requer os seguintes parâmetros:
| Parâmetros | Descrição |
|---|---|
API Root |
Obrigatório O URL raiz da API. Indique o valor no
seguinte formato: |
Username |
Obrigatório O nome de utilizador com o qual estabelecer ligação. |
Password |
Obrigatório A palavra-passe para estabelecer ligação. |
Verify SSL |
Obrigatório Se esta opção estiver selecionada, a integração verifica se o certificado SSL para a ligação ao servidor CyberArk é válido. Selecionado por predefinição. |
CA Certificate |
Obrigatório O certificado da AC a usar para validar a ligação segura à raiz da API. Este parâmetro aceita o certificado da AC sob a forma de uma string codificada em Base64. |
Client Certificate |
Opcional Se estiver configurado para o CyberArk PAM, especifique o certificado do cliente CyberArk a usar para estabelecer uma ligação à raiz da API. Faculte o certificado como o ficheiro PFX (no formato PKCS #12). |
Client Certificate Passphrase |
Opcional A frase secreta necessária para o certificado de cliente. |
Para mais informações sobre como configurar a integração no Google SecOps SOAR, consulte o artigo Configure integrações.
Ações
A integração do CyberArk PAM inclui as seguintes ações:
Obtenha o valor da palavra-passe da conta
Use a ação Get Account Password Value para obter o valor da palavra-passe da conta do CyberArk.
Com esta ação, pode obter a palavra-passe e a chave SSH.
Esta ação não é executada em entidades do Google SecOps.
Dados de ações
A ação Get Account Password Value requer os seguintes parâmetros:
| Parâmetros | Descrição |
|---|---|
Account |
Obrigatório
O ID da conta para a qual pretende obter o valor da palavra-passe. Nota: pode obter o ID da conta através da ação List Accounts (Listar contas). |
Reason |
Obrigatório
O motivo para aceder ao valor da palavra-passe da conta. O valor predefinido é obtido automaticamente do Google SecOps SOAR. |
Ticketing System Name |
Opcional
O nome do sistema de emissão de bilhetes. |
Ticket ID |
Opcional
O ID do pedido do sistema de emissão de bilhetes. |
Version |
Opcional
A versão do valor da palavra-passe da conta a obter. |
Resultados da ação
A ação Get Account Password Value fornece as seguintes saídas:
| Tipo de saída da ação | Disponibilidade |
|---|---|
| Fixação à parede da caixa | Não disponível |
| Link da parede da caixa | Não disponível |
| Mesa de parede para caixas | Não disponível |
| Tabela de enriquecimento | Não disponível |
| Resultado JSON | Disponível |
| Mensagens de saída | Disponível |
| Resultado do script | Disponível |
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação Get Account Password Value:
{
"content": "PASSWORD_VALUE"
}
Mensagens de saída
A ação Get Account Password Value (Obter valor da palavra-passe da conta) fornece as seguintes mensagens de saída:
| Mensagem de saída | Descrição da mensagem |
|---|---|
Successfully fetched password value for account ID
ACCOUNT_ID
|
Ação efetuada com êxito. |
Error executing action "Get Account Password Value". Reason:
ERROR_REASON |
Falha na ação. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais. |
Resultado do script
A tabela seguinte descreve os valores do resultado do script quando usa a ação Get Account Password Value:
| Nome do resultado do script | Valor |
|---|---|
is_success |
True ou False |
Listar contas
Use a ação List Accounts para listar as contas disponíveis no CyberArk PAM com base nos critérios fornecidos.
Esta ação não é executada em entidades SOAR do Google SecOps.
Dados de ações
A ação List Accounts requer os seguintes parâmetros:
| Parâmetros | Descrição |
|---|---|
Search Query |
Obrigatório A consulta de pesquisa a usar. |
Search operator |
Obrigatório O operador de pesquisa a usar para executar uma pesquisa com base na consulta de pesquisa fornecida. Os valores possíveis são os seguintes:
O valor predefinido é |
Max Records To Return |
Obrigatório O número de registos a devolver. Se não fornecer nenhum valor, a ação devolve 50 registos (predefinição da API). |
Records Offset |
Obrigatório O desvio para a ação devolver os valores. |
Filter Query |
Obrigatório A consulta de filtro a usar. Pode basear o filtro nos parâmetros |
Saved Filter |
Obrigatório A consulta de filtro guardada a usar. Este parâmetro
tem prioridade sobre o parâmetro |
Resultados da ação
A ação List Accounts fornece os seguintes resultados:
| Tipo de saída da ação | Disponibilidade |
|---|---|
| Fixação à parede da caixa | Não disponível |
| Link da parede da caixa | Não disponível |
| Mesa de parede para caixas | Disponível |
| Tabela de enriquecimento | Não disponível |
| Resultado JSON | Disponível |
| Mensagens de saída | Disponível |
| Resultado do script | Disponível |
Tabela de parede da caixa
Numa Case Wall, a ação List Accounts apresenta a seguinte tabela:
Nome da tabela: Available PAM Accounts
Colunas da tabela:
- ID
- Nome seguro
- Nome de utilizador
- Tipo de segredo
Resultado JSON
O exemplo seguinte descreve o resultado JSON recebido quando usa a ação List Accounts:
{
"value": [
{
"categoryModificationTime": 1672051160,
"platformId": "WinDomain",
"safeName": "UserTestSafe",
"id": "33_3",
"name": "user@example.com",
"address": "user@example.com",
"userName": "user",
"secretType": "password",
"platformAccountProperties": {},
"secretManagement": {
"automaticManagementEnabled": true,
"lastModifiedTime": 1672051160
},
"createdTime": 1672051160
}
],
"count": 1
}
Mensagens de saída
A ação List Accounts apresenta as seguintes mensagens de saída:
| Mensagem de saída | Descrição da mensagem |
|---|---|
|
Ação efetuada com êxito. |
Error executing action "List Accounts". Reason:
ERROR_REASON |
Falha na ação. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais. |
Resultado do script
A tabela seguinte descreve os valores do resultado do script quando usa a ação List Accounts:
| Nome do resultado do script | Valor |
|---|---|
is_success |
True ou False |
Tchim-tchim
Use a ação *Ping para testar a conetividade com o CyberArk.
Esta ação não é executada em entidades do Google SecOps.
Entradas de integração
Nenhum.
Resultados da ação
A ação Ping fornece os seguintes resultados:
| Tipo de saída da ação | Disponibilidade |
|---|---|
| Fixação à parede da caixa | Não disponível |
| Link da parede da caixa | Não disponível |
| Mesa de parede para caixas | Não disponível |
| Tabela de enriquecimento | Não disponível |
| Resultado JSON | Não disponível |
| Mensagens de saída | Disponível |
| Resultado do script | Disponível |
Mensagens de saída
A ação Ping apresenta as seguintes mensagens de saída:
| Mensagem de saída | Descrição da mensagem |
|---|---|
Successfully connected to the CyberArk PAM installation with the
provided connection parameters! |
Ação efetuada com êxito. |
Failed to connect to the CyberArk PAM installation! Error is
ERROR_REASON |
Falha na ação. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais. |
Resultado do script
A tabela seguinte descreve os valores para o resultado do script quando usa a ação Ping:
| Nome do resultado do script | Valor |
|---|---|
is_success |
True ou False |
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.