> ## 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.

# Configuração de inicialização de PII de operações do SPI

> O SPI exige uma chave AES-256 válida para PII de operações e um pepper de blind index com pelo menos 32 caracteres em cada ambiente.

10 de agosto de 2026Correção de documentaçãoAção necessária

## Afeta

***

Equipes que fazem deploy ou operam o serviço SPI para operações Pix em qualquer ambiente, inclusive desenvolvimento e produção.

## O que mudou

***

A documentação agora afirma corretamente que dois valores que protegem o PII de operações são obrigatórios em cada ambiente:

* `SPI_OPERATIONS_PII_ENCRYPTION_KEY` deve ser uma chave AES-256 válida.
* `SPI_OPERATIONS_BLIND_INDEX_PEPPER` deve conter pelo menos 32 caracteres.

O serviço SPI recusa começar quando qualquer um dos valores está ausente, malformado ou curto demais. Esta é uma correção de documentação; o comportamento de runtime não mudou.

## Impacto

***

**Classificação: Ação necessária.** A redação anterior não deixava explícito o requisito de inicialização. Um deploy que omite qualquer um dos valores, ou que fornece um valor inválido, não pode começar o serviço SPI.

## O que você precisa fazer

***

**Step 1**

Antes da próxima inicialização ou novo deploy do SPI, forneça os dois valores pelo seu gerenciador de segredos em cada ambiente.

**Step 2**

Verifique que a chave de criptografia é uma chave AES-256 válida e que o pepper de blind index contém pelo menos 32 caracteres.

**Step 3**

Não faça commit nem log de nenhum dos dois valores. Planeje uma reindexação ou recriptografia antes de rotacionar um pepper ou uma chave.

### Prazo

Sem prazo imposto pelo produto. Conclua esta validação antes da sua próxima inicialização ou novo deploy do SPI.

## Recursos

***

* [Variáveis de ambiente do SPI](https://docs.lerian.studio/pt/rails/spi/spi-environment-variables.md)
* [O que é o Lerian SPI?](https://docs.lerian.studio/pt/rails/spi/what-is-lerian-spi.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.