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

# Domínio próprio

> Abra a verificação num endereço da sua empresa, com um proxy reverso para verify.omni-ward.com

A verificação hospedada fica em `verify.omni-ward.com`. Se você quer que a pessoa veja um endereço seu, como `verificacao.suaempresa.com.br`, coloque um proxy reverso na frente. O fluxo, as telas e a API continuam os mesmos.

## Como funciona

1. Você aponta um subdomínio seu para um proxy (Nginx, Cloudflare, o load balancer da sua nuvem).
2. O proxy repassa **todos os caminhos** para `https://verify.omni-ward.com`, sem mudar o caminho nem o corpo.
3. Ao entregar o link da sessão, você troca o host de `verify.omni-ward.com` pelo seu subdomínio.

A página da verificação chama a API pelo próprio endereço (`/v1/hosted/...`), então o proxy cobre tudo. Não há cookie de sessão: a sessão anda num cabeçalho, e o link continua sendo de uso único.

## Exemplo com Nginx

```nginx theme={null}
server {
  listen 443 ssl http2;
  server_name verificacao.suaempresa.com.br;
  # certificado do seu domínio
  ssl_certificate     /etc/ssl/verificacao.crt;
  ssl_certificate_key /etc/ssl/verificacao.key;

  client_max_body_size 12m;          # fotos e PDFs do documento

  location / {
    proxy_pass https://verify.omni-ward.com;
    proxy_ssl_server_name on;
    proxy_set_header Host verify.omni-ward.com;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_read_timeout 120s;          # leitura do documento e prova de vida
  }
}
```

## Trocar o host do link

```js theme={null}
const { url } = await criarSessao(); // https://verify.omni-ward.com/v/...
const link = url.replace('https://verify.omni-ward.com', 'https://verificacao.suaempresa.com.br');
```

## Cuidados

* **HTTPS é obrigatório.** Sem ele o navegador não libera a câmera.
* **Iframe e WebView:** inclua o seu subdomínio em `allowedOrigins` da sessão quando embutir a verificação. Veja [Iframe e WebView](https://api-docs.omni-ward.com/sdk/iframe-e-webview.md).
* **IP e localização da pessoa:** o Omni-Ward vê o endereço do seu proxy, não o da pessoa. A localização por IP no painel e o limite de tentativas por endereço passam a valer para o proxy. Se essa informação importa no seu fluxo, prefira o endereço `verify.omni-ward.com`.
* **Não altere as respostas.** O proxy só repassa. Mudar cabeçalhos de segurança (como `Content-Security-Policy`) pode quebrar a câmera ou o iframe.


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