- 3 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
DEL | Inativar credencial
- 3 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
Inative uma credencial no PAM Core.
Requisitos
- Autorização com permissão de acesso e de leitura e escrita 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. - Uma credencial ativa no PAM Core.
Acesse os documentos POST | Criar credencial e PUT | Ativar credencial para mais informações.
Inativar credencial por id
- Requisição
DEL
/api/pam/credential/[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/5
Resposta
HTTP/1.1 200 OK
{
"code": 200,
"response": {
"status": 200,
"message": "Credential successfully deactivated",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Credential successfully deactivated",
"erro": false,
"cod_erro": 0
}
}
Inativar credencial por username@hostname
- Requisição
DEL
/api/pam/credential/[username@hostname]
Parâmetros da requisição
Envie o parâmetro abaixo no path da URL.
username@hostname
- string - obrigatório - Nome de usuário (username
) e nome do host do dispositivo (hostname
) associados à credencial separados por um sinal de @.Nota: esses valores são informados pelo usuário em POST | Criar credencial e são obtidos na resposta da requisição GET | Listar todas as credenciais.
Exemplo:
[email protected]
Caso o username
fornecido possua um @, como em johndoe@senhasegura
, o endpoint não funcionará como esperado devido ao conflito gerado pela presença de dois símbolos @ no endpoint.
Exemplo de requisição
DEL
{{url}}/api/pam/credential/[email protected]
Resposta
HTTP/1.1 200 OK
{
"code": 200,
"response": {
"status": 200,
"message": "Credential successfully deactivated",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Credential successfully deactivated",
"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 se os valores dos parâmetros usados para buscar pela credencial estão corretos e envie a requisição novamente.
Mensagem: "1008: Credential inactive"
Possível causa: a credencial já está inativa.
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: "1010: The item is not a credential"
Possível causa: o valor do parâmetro id
não corresponde a uma credencial.
Solução: verifique o id
e 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.