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

# Lerian Cloud (SaaS) e BYOC

> Entenda como fazer o deploy da Lerian, no Lerian Cloud (SaaS) ou por meio do BYOC na sua própria infraestrutura, e escolha o modelo que atende às suas necessidades de compliance e escala.

A Lerian oferece dois modelos de deploy para sua plataforma completa e modular: **Lerian Cloud (SaaS)** e **BYOC** (Bring Your Own Cloud). O modelo de deploy define quem opera a infraestrutura. Sua licença e seu acordo comercial definem quais módulos estão disponíveis.

Escolha o modelo que se adapta à sua maturidade operacional, aos seus requisitos de compliance e à estrutura da sua equipe. A disponibilidade depende da licença permitida e do acordo comercial.

## Lerian Cloud (SaaS): totalmente gerenciado pela Lerian

***

No Lerian Cloud, a Lerian hospeda e opera a plataforma para você. Sua equipe foca na construção de produtos financeiros. Nós cuidamos de tudo o que fica por baixo.

**O que a Lerian gerencia:**

* Infraestrutura de nuvem (computação, armazenamento e rede)
* Provisionamento de banco de dados, backups e escalonamento
* Patches de segurança e atualizações no nível do sistema operacional
* Upgrades de aplicação e gerenciamento de versões
* Monitoramento, alertas e resposta a incidentes
* Alta disponibilidade e recuperação de desastres

**O que você gerencia:**

* Configuração de negócio (organizações, ledgers, contas e regras)
* Integrações de API com seus sistemas
* Acesso de usuários e permissões dentro da plataforma
* Obrigações de compliance específicas da sua instituição

> [!TIP]
>
> O Lerian Cloud é ideal se você quer o caminho mais rápido até a produção sem construir ou manter infraestrutura. A Lerian opera a plataforma para você desde o primeiro dia.

## BYOC (Bring Your Own Cloud)

***

No modelo BYOC, você faz deploy e opera a Lerian na sua própria infraestrutura. Isso pode ser uma nuvem pública (AWS, GCP, Azure), uma nuvem privada ou on-premises.

Você tem controle total sobre o ambiente. A Lerian fornece o software, Helm Charts (Um pacote pré-configurado para fazer deploy de software no Kubernetes. Pense nele como um template de instalação pronto para uso que automatiza a instalação e a configuração.), Terraform templates (Uma ferramenta de automação de infraestrutura que provisiona e gerencia recursos de nuvem (servidores, bancos de dados, redes) por meio de arquivos de configuração em vez de configuração manual.) e as ferramentas para tornar o deploy e o gerenciamento de ciclo de vida simples.

**O que a Lerian fornece:**

* Software de aplicação (imagens de container e Helm Charts)
* [Terraform templates](https://docs.lerian.studio/pt/products/midaz/midaz-terraform-foundation.md) para provisionamento de infraestrutura
* [Lifecycle Management](https://docs.lerian.studio/pt/platform/lifecycle-management.md): um agente no seu cluster, pelo qual a Lerian instala e faz upgrade de produtos
* Patches de segurança e atualizações de aplicação (entregues pela Lerian e aplicados por você ou pela Lerian pelo Lifecycle Management)

**O que você gerencia:**

* Infraestrutura de nuvem e clusters Kubernetes (Uma plataforma para executar e gerenciar aplicações de software em escala, que lida automaticamente com deploy, escalabilidade e recuperação em vários servidores.)
* Administração de banco de dados, backups e escalonamento
* Segurança de rede (regras de firewall, isolamento de rede e roteamento de tráfego)
* Aplicação de patches no nível do sistema operacional e de containers
* Monitoramento e pipelines de observabilidade
* Criptografia, gerenciamento de segredos e controle de acesso

> [!TIP]
>
> O BYOC é ideal se sua organização exige soberania total dos dados, tem restrições regulatórias rígidas sobre onde os dados residem, ou já tem uma equipe de engenharia de plataforma estabelecida.

### Por que Helm para deploys BYOC

A Lerian publica Helm charts (Um pacote pré-configurado para fazer deploy de software no Kubernetes. Pense nele como um template de instalação pronto para uso que automatiza a instalação e a configuração.) oficiais para os produtos e componentes de plataforma aceitos, através do seu repositório Helm. O Helm é a forma recomendada de fazer deploy, configurar e gerenciar a plataforma na sua infraestrutura.

* **Reprodutibilidade**: todo deploy a partir da mesma versão do chart produz o mesmo resultado. Sem surpresas do tipo "funciona no meu cluster" entre ambientes de staging, produção ou recuperação de desastres.
* **Rollback**: o Helm mantém um histórico de cada release. Voltar para uma versão anterior é um único comando. Você não precisa reconstruir o estado anterior manualmente.
* **Risco operacional reduzido**: os charts codificam os detalhes de configuração (variáveis de ambiente, portas, dependências), então sua equipe não precisa memorizá-los. Revise seus values e os manifests renderizados. O Helm não elimina o risco operacional.
* **Tempo até a produção mais rápido**: em vez de escrever manifests do Kubernetes do zero, comece com os charts oficiais da Lerian e ajuste um único arquivo values. Dias de edição de YAML viram uma tarde de ajuste de parâmetros.
* **Pronto para GitOps**: os charts se integram naturalmente a workflows de GitOps (ArgoCD, Flux). A configuração de deploy fica no controle de versão, as mudanças passam por pull requests e cada deploy é rastreável até um commit específico.

Para instruções de instalação passo a passo, consulte o [README do chart do Midaz](https://github.com/LerianStudio/helm/blob/main/charts/midaz/README.md#install-midaz-helm-chart).

### Variações do BYOC

Para produtos que aceitam multi-tenancy, o BYOC aceita duas configurações:

| Configuração | Descrição | Ideal para |
| :- | :- | :- |
| **Single-Tenant** | Um ambiente dedicado por instituição | Instituições grandes com requisitos rígidos de isolamento |
| **Multi-Tenant** | Um ambiente atendendo várias subsidiárias ou clientes | Instituições que operam como uma plataforma ou gerenciam subsidiárias |

> [!NOTE]
>
> O Lerian Cloud opera como um ambiente multi-tenant gerenciado pela Lerian. Se você precisa de infraestrutura dedicada e isolada, escolha o BYOC Single-Tenant.

## Como seu modelo de deploy afeta a integração com a API do Midaz

***

A superfície da API do Midaz é idêntica em todos os modelos de deploy: os mesmos endpoints, os mesmos payloads, as mesmas respostas. A diferença está em como funcionam a autenticação e o escopo de tenant.

**Lerian Cloud e BYOC Multi-Tenant (Midaz)**

Seu contexto de tenant é estabelecido automaticamente pelo seu token de autenticação. Não há header de tenant para passar nem ID de tenant para gerenciar manualmente.

* Você se autentica via [Access Manager](https://docs.lerian.studio/pt/platform/access-manager.md) e recebe um JWT.
* Esse token inclui seu contexto de tenant.
* Toda chamada de API é automaticamente restrita ao escopo do seu tenant: organizações, ledgers, contas e transações ficam todas isoladas.
* Você nunca interage com dados de outros tenants, e eles nunca interagem com os seus.

**BYOC Single-Tenant (Midaz)**

Configure a autenticação com `PLUGIN_AUTH_ENABLED`. O valor padrão é `false` para onboarding local e de desenvolvimento. Deploys de produção devem defini-lo como `true`. Deploys BYOC Multi-Tenant também exigem essa configuração. Em um ambiente single-tenant que não seja de produção e com a autenticação desabilitada, as chamadas de API não exigem um token.

> [!TIP]
>
> Para uma análise mais profunda de como funciona o isolamento de tenant, veja [Multi-tenancy](https://docs.lerian.studio/pt/platform/multi-tenancy.md).

## Resumo geral

***

| | **Lerian Cloud (SaaS)** | **BYOC** |
| :- | :- | :- |
| **Quem gerencia a infraestrutura?** | Lerian | Sua equipe |
| **Onde os dados ficam?** | Nuvem gerenciada pela Lerian | Sua nuvem ou on-premises |
| **Tempo até a produção** | Semanas | Depende do seu cronograma de provisionamento |
| **Esforço operacional** | Baixo: a Lerian cuida das operações | Maior: sua equipe opera a plataforma |
| **Ideal para** | Equipes que querem focar no produto, não na infraestrutura | Organizações com requisitos rígidos de residência de dados ou compliance |

> [!TIP]
>
> Não sabe qual modelo é o mais adequado? Vá para ["Qual modelo é o certo para você?"](#which-model-is-right-for-you) logo abaixo.

## Comparando os modelos

***

| | **Lerian Cloud (SaaS)** | **BYOC** |
| :- | :- | :- |
| **Infraestrutura** | Gerenciada pela Lerian | Gerenciada por você |
| **Localização dos dados** | Nuvem gerenciada pela Lerian | Sua nuvem ou on-premises |
| **Soberania dos dados** | Dados hospedados na infraestrutura de nuvem gerenciada pela Lerian | Os dados ficam hospedados no seu ambiente; você controla a residência e a saída de dados de acordo com sua arquitetura e os serviços contratados. |
| **Responsabilidade de segurança** | Compartilhada (a Lerian gerencia infraestrutura e aplicação) | Compartilhada (você gerencia a infraestrutura, a Lerian gerencia a aplicação) |
| **Tempo até a produção** | Semanas: nenhuma configuração de infraestrutura necessária | Depende do cronograma de provisionamento da sua equipe |
| **Sobrecarga operacional** | Baixa: a Lerian cuida das operações | Maior: sua equipe opera a plataforma |
| **Personalização** | Configuração padrão | Controle total sobre infraestrutura e rede |
| **Compliance** | O ambiente da Lerian atende aos padrões de segurança | Você garante que seu ambiente atenda aos seus requisitos regulatórios |
| **Atualizações** | Aplicadas pela Lerian | Aplicadas por você com Helm, ou pela Lerian pelo Lifecycle Management |
| **Escalabilidade** | Gerenciada pela Lerian | Gerenciada por você |

## Qual modelo é o certo para você?

***

**Escolha o Lerian Cloud se:**

* Você quer entrar em produção rapidamente sem provisionar infraestrutura
* Sua equipe prefere focar em produto e integração, não em operações
* Você não tem requisitos rígidos para que os dados permaneçam no seu próprio ambiente

**Escolha o BYOC se:**

* Regras regulatórias ou de compliance exigem que os dados permaneçam na sua infraestrutura
* Você precisa de controle total sobre rede, criptografia e políticas de acesso
* Sua organização tem uma equipe de plataforma ou DevOps pronta para operar cargas de trabalho de Kubernetes
* Você quer integrar a Lerian a um ambiente de nuvem existente com restrições arquiteturais específicas

## Próximos passos

***

> [card] [Primeiros passos](https://docs.lerian.studio/pt/start-here/getting-started.md)
>
> Siga o guia passo a passo para configurar seu primeiro Ledger e executar transações.

> [card] [Segurança](https://docs.lerian.studio/pt/products/midaz/security.md)
>
> Saiba como funciona o modelo de responsabilidade compartilhada em cada opção de deploy.

> [card] [Estratégias de deploy](https://docs.lerian.studio/pt/products/midaz/deployment.md)
>
> Explore as opções de Kubernetes, Helm e Terraform para deploys BYOC.


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