POST | Criar dispositivo
- 4 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
POST | Criar dispositivo
- 4 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
Resumo do artigo
Você achou este resumo útil?
Obrigado por seu feedback
Crie um dispositivo 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.
Requisição
POST /api/pam/device
Parâmetros de requisição
Envie os parâmetros abaixo no body da requisição.
ip- string - obrigatório - Endereço IP do dispositivo.
hostname- string - obrigatório - Nome do host do dispositivo.
Info
Se o hostname fornecido corresponder ao de um dispositivo previamente criado, esta requisição atualizará o dispositivo existente. Caso contrário, ela criará um novo dispositivo e o associará a este hostname.
model- string - obrigatório - Modelo do dispositivo.
Nota: um novo modelo é criado se o valor for único.
type- string - obrigatório - Tipo de dispositivo.
Nota: um novo tipo é criado se o valor for único.
vendor- string - obrigatório - Fabricante do dispositivo.
Nota: um novo fabricante é criado se o valor for único.
site- string - obrigatório - Localização do dispositivo.
Nota: um novo site é criado se o valor for único.
device_domain- string - Nome ou abreviação do domínio.
Nota: apenas domínios previamente registrados são aceitos.
Exemplo: api,app
Atenção
Ao listar mais de um device_domain, adicione vírgulas sem espaço entre eles, conforme o exemplo a seguir:
testlab.com,demo.lab.com
device_tags- string - Palavras-chave associadas ao dispositivo.
connectivities- string - Conectividade do dispositivo.
session_remote_config- string - Expressão do login.
Exemplo de requisição
POST {{url}}/api/pam/device
{
"ip": "10.66.33.120",
"hostname": "API device test",
"model": "Gmail",
"type": "Desktop",
"vendor": "Linux",
"site": "AWS"
}
Resposta
HTTP/1.1 201 CREATED
{
"code": 201,
"response": {
"status": 201,
"message": "Device successfully registered!",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Device successfully registered!",
"erro": false,
"cod_erro": 0
},
"device": {
"id": "17",
"hostname": "API device test",
"ip": "10.66.33.120",
"model": "Gmail",
"type": "Desktop",
"vendor": "Linux",
"site": "AWS",
"device_domain": "",
"connectivities": "",
"session_remote_config": "",
"device_tags": ""
}
}
Erros
400 - Bad Request.
Mensagem: "1004: The device's hostname was not informed"
Possível causa: o parâmetro obrigatório hostname do dispositivo não foi informado.
hostname do dispositivo e envie a requisição novamente.Mensagem: "1005: The device's IP was not informed"
Possível causa: o parâmetro obrigatório ip do dispositivo não foi informado.
ip do dispositivo e envie a requisição novamente.Mensagem: "1019: The device's site was not informed"
Possível causa: o parâmetro obrigatório site do dispositivo não foi informado.
site e envie a requisição novamente.Mensagem: "1020: The device's model was not informed"
Possível causa: o parâmetro obrigatório model do dispositivo não foi informado.
model e envie a requisição novamente.Mensagem: "1021: The device's vendor was not informed"
Possível causa: o parâmetro obrigatório vendor do dispositivo não foi informado
vendor e envie a requisição novamente.Mensagem: "1022: The device's type was not informed"
Possível causa: o parâmetro obrigatório type do dispositivo não foi informado.
type e envie a requisição novamente.Mensagem: "1029: It is not possible to enter a domain that has not been previously registered"
Possível causa: não é possível enviar um domínio que não tenha sido registrado.
device_domain 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 de dispositivo.
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 garanta que todos os parâmetros estão corretos.
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.
Invalid signature.
Mensagem: "Invalid signature"
Possível causa: falha no reconhecimento da URL da aplicação cliente.
Solução: verifique a URL da aplicação cliente e envie a requisição novamente.
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?
