- 3 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
GET | Listar uma senha por [identifier]
- 3 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
Acesse informações de uma senha armazenada no MySafe.
Requisitos
- Acesso à senha no MySafe.
Requisição
GET
api/mysafe/password/[identifier]
Parâmetros de requisição
Envie o parâmetro abaixo no path da URL.
Nota: este valor é automaticamente atribuído pelo senhasegura em POST | Criar senha e é obtido na resposta da requisição GET | Listar todas as senhas.identifier
- int - obrigatório - Código único de identificação da senha.
Exemplo de requisição
GET
{{url}}api/mysafe/password/5
Resposta
HTTP/1.1 200 OK
{
"code": 200,
"response": {
"status": 200,
"message": "Success",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Success",
"erro": false,
"cod_erro": 0
},
"password_entity": {
"identifier": "5",
"name": "gmail corporate",
"url": "www.gmail.com",
"username": "[email protected]",
"password": "7yha&thisismycorporatepassword78%h",
"secret_key": null,
"token": null,
"notes": "my gmail password",
"tags": "gmail",
"users_allowed": [],
"groups_allowed": []
}
}
Campos do corpo da resposta
passwords_entity
- object - Dado da senha armazenada.identifier
- int - Código único de identificação da senha.name
- string - Nome da senha.url
- string - URL do site onde a senha está sendo utilizada.username
- string Nome de usuário usado para acessar a conta.password
- string - Senha cadastrada.Nota: essa informação pode vir criptografada caso sua autorização de chave de acesso esteja configurada para criptografar dados sensíveis.
secret_key
- string - A chave secreta fornecida para autenticação multi-fator.token
- string - Código TOTP gerado automaticamente pelo senhasegura para autenticação multi-fator com base no token fornecido em POST | Criar senha.tags
- string - Palavras-chave associadas à senha.users_allowed
- array de objetos - Dados dos usuários com acesso à senha.username
- string - Nome do usuário com permissão de acesso à senha.can_edit
- boolean - Permissão de edição.Usuários com permissão can_edit
= true
podem inativar uma senha.
groups_allowed
- array de objetos - Dados dos grupos com acesso à senha.name
- string - Nome do grupo com permissão de acesso à senha.can_edit
- boolean - Permissão de edição.Membros de grupos com permissão can_edit
= true
podem inativar uma senha.
Erros
400 - Bad Request.
Mensagem: "1010: Unexpected identifier type"
Possível causa: o identifier
enviado não foi reconhecido como um identificador válido.
identifier
e envie a requisição novamente.Mensagem: "1005: Password not found"
Possível causa: senha não encontrada.
identifier
e envie a requisição novamente.Mensagem: "1006: User does not have access"
Possível causa: usuário não possui acesso à senha.
Mensagem: "1009: Inactive password"
Possível causa: senha inativa.
POST
api/mysafe/password/active[identifier]
.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.
No route matched with those values.
Mensagem: "No route matched with those values."
Possíveis causas: falha na autenticação da sua aplicação com o servidor senhasegura ou URL incorreta.
Solução: verifique os parâmetros de autenticação como Access Token URL
, Client ID
e Client Secret
e solicite um novo token de acesso ou verifique e corrija a URL.
An invalid response was received from the upstream server .
Mensagem: "An invalid response was received from the upstream server
Possível causa: o servidor upstream pode estar demorando muito para responder, levando a um erro de timeout que é interpretado como uma resposta inválida pelo servidor proxy/gateway.
Solução: verifique a conectividade entre a origem da requisição e o servidor senhasegura.
The upstream server is timing out.
Mensagem: "An invalid response was received from the upstream server"
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.