PUT | Atualizar senha
  • 3 minutos de leitura
  • Tema escuro
    Tema claro
  • Pdf

PUT | Atualizar senha

  • Tema escuro
    Tema claro
  • Pdf

Resumo do artigo

Atualize uma senha no MySafe.

Requisitos

  • Permissão de edição de senha no MySafe.

Requisição

PUT api/mysafe/password/update[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.


Envie os parâmetros que deseja atualizar no body da requisição.

  • name - string - Nome atribuído à senha


  • username - string - Nome de usuário usado para acessar a conta.


  • password - string - A senha que está sendo atualizada.


  • url - string - URL do site onde a senha está sendo usada.


  • secret_key - string - Seed para gerar automaticamente o TOTP.

Nota: deve estar codificada em base32.


  • notes - string - Observações adicionais sobre a senha.


  • tags - string - Palavras-chave associadas à senha.


  • users_allowed - array de objetos - Dados dos usuários com acesso à senha.Nota: o envio de um array vazio, remove as permissões de compartilhamento.


    →username - string - Nome do usuário com permissão de acesso à senha.


    →can_edit - boolean - Permissão de edição.    Nota: se deixado vazio, usuários terão apenas permissão de visualização.


Atenção

Usuários com permissão can_edit = true podem inativar uma senha.


  • groups_allowed - array de objetos - Dados dos grupos com permissão de acesso à senha.Nota: o envio de um array vazio, remove as permissões de compartilhamento.


    →name - string - Nome do grupo com permissão de acesso à senha.


    →can_edit - boolean - Permissão de edição.    Nota: se deixado vazio, membros do grupo terão apenas permissão de visualização.


Atenção

Membros de grupos com permissão can_edit = true podem inativar uma senha.

Exemplo de requisição

PUT api/mysafe/password/update/9

{
    "name": "senseg account",
    "url": "www.senhasegura.com",
    "username": "npass",
    "password": "8jhfy@3789",
    "secret_key": "JBSWY3DPEHPK3PXP",
    "notes": "Access details",
    "tags": "tag1, tag2",
    "users_allowed": [
        {
            "username" : "pduarte"
        }
    ],
    "groups_allowed": [
        {
            "name" : "Test group",
            "can_edit" : false
        }
    ]
}

Resposta

HTTP/1.1 200 OK
 {
    "code": 200,
    "response": {
        "status": 200,
        "message": "Password successfully updated",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "Password successfully updated",
        "erro": false,
        "cod_erro": 0
    },
    "password_entity": {
        "identifier": "312",
        "name": "senhasegura account",
        "url": "www.url.com",
        "username": "senhapass",
        "note": "Access details for this key.",
        "tags": "access",
        "users_allowed": [
            {
                "username": "pduarte",
                "can_edit": true
            }
        ],
        "groups_allowed": [
            {
                "name": "Test group",
                "can_edit": true
            }
        ],
        "shared_error": []
    }
}

Erros

400 - Bad Request.

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.


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: "You are not authorized to access this resource."

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 a seupstream 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?