GET | Listar uma senha por [identifier]
  • 3 minutos de leitura
  • Tema escuro
    Tema claro
  • Pdf

GET | Listar uma senha por [identifier]

  • Tema escuro
    Tema claro
  • Pdf

Resumo do artigo

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.

  • identifier - int - obrigatório - Código único de identificação da senha.Nota: este valor é automaticamente atribuído pelo senhasegura em POST | Criar senha e é obtido na resposta da requisição GET | Listar todas as senhas.

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.


Atençã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.


Atençã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.

Solução: verifique o valor do identifier e envie a requisição novamente.

Mensagem: "1005: Password not found"

Possível causa: senha não encontrada.

Solução: verifique o valor do 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.

Solução: ative a senha através do 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.



Este artigo foi útil?

What's Next