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

# Contrato de autenticação e de mapeamento de atores do Matcher

> O Matcher aceita autenticação plugin-auth ou desabilitada, e as permissões de mapeamento de atores usam nomes com hífen.

<Badge stroke icon="calendar-days" iconType="regular">31 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Correção da documentação</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Ação necessária</Badge>

## Afeta

Equipes que configuram a autenticação do Matcher, deploys multi-tenant ou o acesso ao mapeamento de atores.

## O que mudou

A documentação agora informa corretamente que o Matcher aceita `plugin-auth` ou `disabled` em `AUTH_PROVIDER`. O antigo provedor `workos` foi descontinuado e o Matcher o rejeita. `disabled` desliga a autenticação e a autorização e pode expor PII de mapeamento de atores; use `plugin-auth` quando precisar dessas proteções.

As permissões de mapeamento de atores usam nomes com hífen, como `actor-mappings-read` e `actor-mappings-write`. O Console e a API pedem até 25 mapeamentos por página.

Esta é uma correção da documentação do comportamento atual de runtime; ela não anuncia um release de runtime.

## Impacto

**Classificação: Ação necessária.**

## O que você precisa fazer

1. Substitua `AUTH_PROVIDER=workos` se ele aparecer no seu deploy do Matcher e atualize as definições de papéis de mapeamento de atores para usar os nomes de permissão com hífen.
2. Revise os clientes que supõem páginas de 20 itens antes do próximo deploy.

### Prazo

Atualize a configuração afetada e a automação de controle de acesso antes do próximo deploy do Matcher.