GET | Listar todas as credenciais
  • 3 minutos de leitura
  • Tema escuro
    Tema claro
  • Pdf

GET | Listar todas as credenciais

  • Tema escuro
    Tema claro
  • Pdf

Resumo do artigo

Acesse informações de todas as credenciais associadas à sua autorização no PAM Core.

Requisitos

Requisição

GET api/pam/credential

Info

Chaves SSH inseridas como credenciais, também serão listadas nessa resposta. Entretanto, para listar uma chave SSH específica, envie uma requisição GET para o endpoint api/pam/key[id]. Acesse o documento GET | Listar uma chave SSH por [id] para mais informações.

Exemplo de requisição

GET {{url}}/api/pam/credential

Resposta

HTTP/1.1 200 OK
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "2 credentials found",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "2 credentials found",
        "erro": false,
        "cod_erro": 0
    },
    "credentials": [
        {
            "id": "2",
            "identifier": "018f3fe6-10e2-724d-9229-a6e9749fa88e",
            "username": "[email protected]",
            "expiration": "2024-05-16T17:31:31-03:00",
            "change": "2024-05-03 16:19:53",
            "view": "2024-05-24 16:26:09",
            "hostname": "gmail.com",
            "management_ip": "mail.google.com",
            "type": "Local User",
            "type_code": "1",
            "device_model": "Gmail",
            "device_type": "Web Application",
            "device_vendor": "Google",
            "automatic_change": false,
            "connectivity": "HTTPS",
            "connectivity_code": "10"
        },
        {
            "id": "39",
            "identifier": "018fcedb-fbd5-70ff-9864-b81fcd00e410",
            "username": "dleite",
            "expiration": null,
            "change": "2024-05-31 11:03:13",
            "view": null,
            "hostname": "w2016",
            "management_ip": "10.66.33.15",
            "type": "SSH Key",
            "type_code": "1",
            "device_model": "Windows Server 2016",
            "device_type": "Server",
            "device_vendor": "Microsoft",
            "automatic_change": false,
            "connectivity": "RDP",
            "connectivity_code": "13"
        }
    ]
}

Campos do corpo da resposta

  • credentials - array de objetos - Dados das credenciais listadas.
    → id - int - Código único de identificação da credencial.   Nota: esse valor é atribuído automaticamente pelo senhasegura em POST | Criar credencial.


    →identifier - string - String única criada pelo usuário ou pelo senhasegura para identificar a credencial.   Nota: esse valor pode ser atualizado através do endpoint POST api/pam/credential.


    →username - string - Nome do usuário designado à credencial.


    →expiration - string - Data e hora de expiração da credencial em formato ISO 8601.    Exemplo: 2024-05-16T17:31:31-03:00


    →change - string - Data e hora da última alteração na credencial em formato ISO 8601.    Exemplo: 2024-05-03 16:19:53


    →view - string - Data e hora da última visualização da credencial em formato ISO 8601.    Exemplo: 2024-05-24 16:26:09


    →hostname - string - Nome do host do dispositivo associado à credencial.


    →management_ip - string - Endereço IP de gerenciamento associado ao dispositivo da credencial.


    →type - string - Tipo de credencial.


    →type_code - string - Código do tipo de credencial.


    →device_model - string - Modelo do dispositivo associado à credencial.


    →device_type - string - Tipo de dispositivo associado à credencial.


    →device_vendor - string - Fabricante do dispositivo associado à credencial.


    →automatic_change - boolean - Indica se a senha é alterada automaticamente.


    →connectivity - string - Tipo de conectividade da credencial.


    →connectivity_code - string - Código do tipo de conectividade da credencial.

Erros

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 URL, 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.


Este artigo foi útil?