SDK Java (Spring Boot)

A SDK oficial Spring Boot encapsula login, validação de token e autorização RBAC. Você adiciona uma dependência, configura o YAML e anota os endpoints — sem implementar segurança do zero.

Requisitos

Java 17+, Spring Boot 3.x.

Instalação (Maven)

<dependency>
  <groupId>cloud.gatekeeperid</groupId>
  <artifactId>gatekeeper-spring-boot-starter</artifactId>
  <version>0.3.5</version>
</dependency>

Gradle

implementation("cloud.gatekeeperid:gatekeeper-spring-boot-starter:0.3.5")

Configuração (application.yml)

gatekeeper:
  application-name: orders-api
  tenant-id: your-tenant-id
  client-id: your-client-id
  hmac:
    secret: your-hmac-secret

Auth no BFF

A SDK não registra /auth/* sozinha. Crie um controller que delega a GatekeeperAuthService (login, register, refresh, me…). No register, use external_id para vincular o usuário na sua base; campos extras (endereço, etc.) ficam no seu serviço.

Sessão: access_token, refresh_token, expires_in, external_id. Guia: /docs/quickstart.

Proteger rotas

@GatekeeperProtected(permission = "orders:create")
@PostMapping("/orders")
public Map<String, Object> createOrder() {
  return Map.of("status", "CREATED");
}

A SDK sincroniza rotas com o Console. Você aprova permissões no painel e segue codando a regra de negócio.

Artefatos Maven Central

• gatekeeper-spring-boot-starter — auto-config + filtro de autorização
• gatekeeper-core — client HTTP direto

Ver também

SDK Node.js (TypeScript) · Referência da API · OpenAPI · OAuth2 explicado · FAQ