- 2 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
DEL | Liberar custódia de credencial
- 2 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
Libere a custódia de uma credencial no PAM Core.
Quando um usuário realiza uma chamada GET
/api/pam/credential[id]
para visualizar uma credencial, isso é chamado de concessão temporária de custódia dessa credencial ao usuário, também conhecido como account check-in.
Quando o acesso a essa credencial é revogado, isso é descrito como a liberação da custódia da credencial, também conhecido como account check-out.
Acesse o documento Sobre a custódia de credenciais para mais informações sobre o conceito de custódia de credenciais,
Requisitos
Autorização com permissão de acesso ao PAM Core concedidas pelo administrador no A2A.
Acesse o documento sobre Como criar uma autorização para uma aplicação para mais informações.Custódia de uma credencial solicitada via API através do endpoint
GET
/api/pam/credential[id]
.
Access o documento GET | Listar uma credencial para mais informações.
Requisição
DEL
/api/pam/credential/custody/[id]
Parâmetros de requisição
Envie o parâmetro abaixo no path . da URL.
id
- int - obrigatório - Código único de identificação da credencial.Nota: esse valor é automaticamente atribuído pelo senhasegura em POST | Criar credencial e é obtido na resposta da requisição GET | Listar todas as credenciais.
Exemplo de requisição
DEL
{{url}}/api/pam/credential/custody/94
Resposta
HTTP/1.1 200 OK
{
"code": 200,
"response": {
"status": 200,
"message": "Credential custody 94 released",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Credential custody 94 released",
"erro": false,
"cod_erro": 0
}
}
Erros
400 - Bad Request
Mensagem: "1007: Credential not found"
Possível causa: a credencial não foi encontrada.
Solução: verifique o valor do id
e envie a requisição novamente.
Mensagem: "1008: Credential inactive"
Possível causa: a credencial está inativa.
PUT
/api/pam/credential/[id]
e envie a requisição novamente.Mensagem: "1009: No access to credential"
Possível causa: sua autorização não possui acesso à credencial.
Solução: solicite ao administrador que revise sua permissão de acesso à credencial desejada.
Mensagem: "1018: The credential is not in the user custody"
Possível causa: usuário não possui a custódia da credencial.
Solução: consulte a credencial através do endpoint GET
/iso/pam/credential[id]
e após o sucesso dessa chamada, envie a requisição novamente.
Mensagem: "1039: Without PAM Configuration Access permission"
Possível causa: sua autorização não possui permissão de alteração da credencial.
Solução: solicite ao administrador que revise sua permissão de leitura e escrita aos recursos do PAM Core no A2A.
404 - Not Found
Mensagem: "Resource sub not found"
Possível causa: a URL ou o recurso solicitado não está correto.
Solução: verifique a URL e envie a requisição novamente.
500 - Internal Server Error
Mensagem: "Unexpected error."
Possível causa: o erro está no servidor senhasegura.
Solução: contate o time de suporte para mais informações.
Mensagem: "You are not authorized to access this resource"
Possível causa: você não possui autorização para acessar esse recurso.
Solução: solicite ao administrador que revise sua permissão de acesso aos recursos do PAM Core no A2A.
Client authentication failed
Mensagem: "Client authentication failed"
Possível causa: falha na autenticação da sua aplicação com o servidor senhasegura.
Solução: verifique os parâmetros de autenticação como Access Token
, Client ID
e Client secret
e solicite um novo token de acesso.
No route matched with those values
Mensagem: "No route matched with those values"
Possível causa: ausência do header de autorização na requisição de API.
Solução: solicite um novo token de acesso.
Request timed out
Mensagem: "Request timed out"
Possível causa: o tempo da requisição se esgotou.
Solução: verifique a conectividade entre a origem da requisição e o servidor senhasegura.