POST | Criar URL autenticada para sessão web proxy
- 3 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
POST | Criar URL autenticada para sessão web proxy
- 3 minutos de leitura
- Imprimir
- Tema escuroTema claro
- Pdf
Resumo do artigo
Você achou este resumo útil?
Obrigado por seu feedback
Crie uma URL autenticada para iniciar uma sessão web proxy no PAM Core.
Requisitos
- Autorização com permissão de acesso e de leitura e escrita ao Web Proxy Session 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/remote/session
Parâmetros de requisição
Envie os parâmetros abaixo no body da requisição.
user - string - obrigatório - Nome de usuário utilizado para autenticação.Nota: deve ser um usuário cadastrado no usuário.
credential - string - obrigatório - Nome de usuário da credencial utilizada nesta sessão web proxy.device - string - obrigatório - Nome do host ou endereço IP do dispositivo de destino .protocol - string - obrigatório - Protocolo de rede (SSH, RDP, HTTPS, entre outros.).remotedevice - string - ID do dispositivo, endereço IP ou hostname para a sessão web proxy.remoteAddr - string - Endereço IP do usuário.port - int - Porta usada durante toda a sessão.remoteapp - int - ID do RemoteApp.screensize - string - Resolução de tela.Exemplo: 1900x1200
Exemplo de requisição
POST {{url}}/api/pam/remote/session
{
"user": "dleite",
"credential":"usrsudonopass",
"device": "45.163.147.135",
"protocol": "ssh"
}
Resposta
{
"code": 200,
"response": {
"status": 200,
"message": "Session created successfully",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Session created successfully",
"erro": false,
"cod_erro": 0
},
"tenant": "senhasegura",
"session": {
"session_url": "https://10.66.33.120/modulos/auth?_sr=cmJzOi8vTmJQOG1GckRWeHFFY1FkNi8wRUF5bHoweWw3cUdyUk5JbE1oaXZ3TytLak5sUGsydUZ2YnRQaUdhU3YwaUl0TVRILzZHWWtPWjdZdXNKeE01NHFsaVlFdkRqMGZtOG5vbXNDc0d5bUNDdUt2YWFSclJjTG1scUIxSnBUTXdq",
"token": "6a3afbb1************b32262"
}
}
Campos do corpo da resposta
session - object - Dados da sessão criada.session_url - string - URL para iniciar a sessão web proxy autenticada.token - string - Token de autenticação associado à sessão web proxy.Atenção
O valor do token é sensível e deve ser mantido confidencial.
Erros
400 - Bad Request.
Mensagem: "Username not specified"
Possível causa: o parâmetro obrigatório username da sessão não foi informado.
username já cadastrado no senhasegura e envie a requisição novamente.Mensagem: "Credential not specified"
Possível causa: o parâmetro obrigatório credential da sessão não foi informado.
credential e envie a requisição novamente.Mensagem: "Credential device not specified"
Possível causa: o parâmetro obrigatório device da sessão não foi informado.
device do dispositivo e envie a requisição novamente.Mensagem: "Invalid protocol"
Possível causa: o parâmetro obrigatório protocol da sessão não foi informado.
protocol e envie a requisição novamente.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 verifique sua permissão de acesso aos recursos do Web Proxy Session 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?
