18 artigos
Programadores
API, OpenID Connect, SAML, webhooks, recibos assinados e SDKs.
Comece aqui
- APIAPI AuthGuard para integradores: visão geral e convençõesA API AuthGuard serve o endereço de cada organização (por exemplo, https://<slug>.authguard.pt).
- APIAutenticação na API (clientes máquina, tokens SCIM, clientes OIDC)Cada superfície de integração tem a sua credencial.
- OpenID ConnectIntegrar uma aplicação por OpenID ConnectO AuthGuard é um fornecedor OpenID Connect.
- Pedidos de aprovaçãoCriar um pedido de aprovação (API de intents)Um sistema cria um pedido (intent) para que uma pessoa aprove ou recuse uma operação concreta.
- SDKsSDKs AuthGuard (TypeScript, Python, Java, .NET, Go)Os SDKs cobrem a superfície de integração (não a API de administração), com o mesmo comportamento nas cinco linguagens.
Acesso privilegiado (PAM)1 artigo
API5 artigos
- API AuthGuard para integradores: visão geral e convençõesA API AuthGuard serve o endereço de cada organização (por exemplo, https://<slug>.authguard.pt).
- Autenticação na API (clientes máquina, tokens SCIM, clientes OIDC)Cada superfície de integração tem a sua credencial.
- /v1/meta: funcionalidades servidas e estado da organizaçãoGET /v1/meta é público e igual para todos os pedidos ao mesmo endereço.
- Erros da API e limites de pedidosTodas as rotas da API devolvem os erros num envelope único.
- O contrato OpenAPIO contrato público da API é um documento OpenAPI 3.1 mantido junto ao código: docs/openapi/authguard-v1.yaml, com o anexo…
OpenID Connect1 artigo
Pedidos de aprovação4 artigos
- Criar um pedido de aprovação (API de intents)Um sistema cria um pedido (intent) para que uma pessoa aprove ou recuse uma operação concreta.
- Ler a decisão de um pedido e cancelá-loDepois de criar um pedido, o sistema descobre a decisão lendo o pedido ou recebendo um webhook.
- Verificar o recibo assinado de uma decisãoCada decisão sobre um pedido vem com um recibo assinado que o seu sistema pode verificar sem depender do serviço.
- Webhooks das decisões (Standard Webhooks)O serviço avisa o seu sistema das decisões com webhooks assinados segundo a especificação Standard Webhooks.
SAML1 artigo
SDKs6 artigos
- SDKs AuthGuard (TypeScript, Python, Java, .NET, Go)Os SDKs cobrem a superfície de integração (não a API de administração), com o mesmo comportamento nas cinco linguagens.
- SDK .NETO pacote AuthGuard.Sdk usa Microsoft.IdentityModel.JsonWebTokens.
- SDK GoO SDK Go está na pasta sdks/go do repositório (pacote authguard) e usa go-oidc/v3 com go-jose/v4.
- SDK JavaO artefacto pt.authguard:authguard-sdk usa Nimbus JOSE+JWT.
- SDK PythonO pacote authguard-sdk (importado como authguard) usa PyJWT para os JWT.
- SDK TypeScript / Node.jsO pacote @authguard/sdk serve Node.js e usa jose para os JWT.