> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Módulo SSO

> Suporte de Single Sign-On (SSO) para autenticar usuários da Base44 com sistemas externos. Disponível via base44.asServiceRole.sso.

<Warning>
  Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a [documentação para desenvolvedores](/developers).
</Warning>

# Módulo SSO

Suporte de Single Sign-On (SSO) para autenticar usuários da Base44 com sistemas externos. Disponível via `base44.asServiceRole.sso`.

> **Apenas backend**: Este módulo requer acesso de service role e só pode ser usado em funções de backend hospedadas na Base44.

## Métodos

| Método                   | Assinatura                        | Descrição                                               |
| ------------------------ | --------------------------------- | ------------------------------------------------------- |
| `getAccessToken(userId)` | `Promise<SsoAccessTokenResponse>` | Obtém um token de acesso SSO para um usuário específico |

## Exemplos

### Obter token de acesso SSO

```javascript theme={null}
import { createClientFromRequest } from "npm:@base44/sdk";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);

  // Get the current user
  const user = await base44.auth.me();
  if (!user) {
    return Response.json({ error: "Unauthorized" }, { status: 401 });
  }

  // Get SSO access token for this user
  const { access_token } = await base44.asServiceRole.sso.getAccessToken(user.id);

  // Use the token to authenticate with an external system
  return Response.json({ ssoToken: access_token });
});
```

### Obter token para um usuário específico (Service Role)

```javascript theme={null}
Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const { userId } = await req.json();

  // Get SSO token for any user (service role has access to all users)
  const { access_token } = await base44.asServiceRole.sso.getAccessToken(userId);

  return Response.json({ token: access_token });
});
```

## Casos de uso

* Autenticar usuários da Base44 com ferramentas SaaS externas (por exemplo, Okta, Azure AD)
* Construir pontes SSO entre a Base44 e sistemas de terceiros
* Gerar tokens para chamadas autenticadas de backend para backend

## Definições de tipo

```typescript theme={null}
/** Response from the SSO access token endpoint. */
interface SsoAccessTokenResponse {
  /** The SSO access token for the specified user. */
  access_token: string;
}

/** SSO module for managing SSO authentication (service role only). */
interface SsoModule {
  /**
   * Gets an SSO access token for a specific user.
   * @param userid - The Base44 user ID to get the SSO token for.
   * @returns Promise resolving to the SSO access token response.
   */
  getAccessToken(userid: string): Promise<SsoAccessTokenResponse>;
}
```

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>