Descrição
Ative uma sincronização de grupo LDAP inativa na plataforma Segura™. O estado ativo é somente leitura no corpo do recurso, então esta ação é a única forma de defini-lo. Para interromper uma sincronização, acesse POST | Desativar sincronização de grupo LDAP.
Pré-requisitos
- Uma aplicação com a autorização Users concedida pelo administrador no A2A, com a permissão do recurso definida como Leitura e escrita. Para mais informações, acesse Como gerenciar autorizações no A2A.
- Um token de acesso OAuth 2.0 válido. Para mais informações, acesse Como autenticar uma aplicação no A2A.
Requisição
POST /api/v2/iam/ldap-group-syncs/[id]/activate
Parâmetros de caminho
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id |
int | Sim | Código de identificação único da sincronização. |
Cabeçalhos
| Cabeçalho | Obrigatório | Descrição |
|---|---|---|
Content-Type |
Sim | Deve ser application/json, mesmo que a requisição não carregue corpo. |
Atenção
Envie o header Content-Type mesmo com o corpo vazio. Omiti-lo retorna um erro.
Exemplo de requisição POST {{url}}/api/v2/iam/ldap-group-syncs/501/activate
Resposta
HTTP/1.1 204 No Content
A resposta não carrega corpo. Consulte a sincronização com GET | Consultar sincronização de grupo LDAP por [id] para confirmar o novo estado e obter o ETag atualizado.
Erros
| Código HTTP | Mensagem | Causa possível | Solução |
|---|---|---|---|
403 |
api.permission.denied |
A aplicação não tem permissão para este recurso. | Peça ao administrador para verificar a autorização Users da aplicação no A2A. |
404 |
api.resource.not_found |
Não existe sincronização com o código de identificação enviado. | Verifique o id e reenvie a requisição. |
409 |
api.resource.conflict.already_active |
A sincronização já está ativa. | Nenhuma ação é necessária. Consulte o recurso para confirmar seu estado. |
429 |
rate_limit_exceeded |
A aplicação excedeu sua cota de requisições. | Aguarde o período indicado no header Retry-After e reenvie a requisição. |
Erros de autenticação
| Mensagem | Causa possível | Solução |
|---|---|---|
Client authentication failed. |
Falha na autenticação da aplicação com o servidor Segura. | Verifique os parâmetros de autenticação (Access Token URL, Client ID e Client secret) e solicite um novo token de acesso. |
Invalid signature |
Falha no reconhecimento da URL da aplicação cliente. | Verifique a URL da aplicação cliente e reenvie a requisição. |
No route matched with those values. |
Header de autorização ausente na requisição da API. | Solicite um novo token de acesso. |
Request timed out. |
A requisição excedeu o limite de tempo. | Verifique a conectividade entre a origem da requisição e o servidor Segura. |