RPNG-685 Documentar como utilizar captura de geolocation nas sessões de biometria

docs.en-us/articles/rest-pki/core/integration/bio-sessions/configs/geolocation.md

@@ -0,0 +1,4 @@
+# Geolocation configuration - Rest PKI Core
+
+<!-- link to version in Portuguese -->
+<div data-alt-locales="pt-br"></div>

docs.en-us/articles/toc.md

@@ -111,6 +111,9 @@
 #### [Authentication](rest-pki/core/integration/bio-sessions/authentication.md)
 #### [Identification](rest-pki/core/integration/bio-sessions/identification.md)
 #### [Identification Document Capture](rest-pki/core/integration/bio-sessions/id-capture.md)
+#### Settings
+##### [Identifier formats](rest-pki/core/integration/bio-sessions/configs/subject-identifier-formats.md)
+##### [Geolocation](rest-pki/core/integration/bio-sessions/configs/geolocation.md)
 ### [Referencing files](rest-pki/core/integration/file-referencing.md)
 ### [Webhooks](rest-pki/core/integration/webhooks.md)
 ### [Error codes](rest-pki/core/integration/error-codes.md)

docs.pt-br/articles/rest-pki/core/integration/bio-sessions/configs/geolocation.md

@@ -0,0 +1,27 @@
+# Configuração de geolocalização (Geolocation) - Rest PKI Core
+
+Durante uma sessão de biometria, o Rest PKI Core pode capturar a localização geográfica do dispositivo do usuário (latitude e longitude). O recurso vem **desligado por padrão** e pode ser ligado pelo painel, passando a valer para todas as sessões da sua aplicação.
+
+Existem duas configurações:
+
+- **Tipo de captura de geolocalização** — define se a localização é capturada e se ela é obrigatória:
+    - **Desabilitado** (padrão): a localização não é capturada.
+    - **Opcional**: o sistema tenta capturar a localização, mas a sessão continua normalmente caso o usuário não dê permissão ou a captura falhe.
+    - **Obrigatório**: a sessão só prossegue se a localização for capturada com sucesso.
+- **Política de captura de geolocalização** — define em quais aparelhos a localização é coletada (importante nos fluxos com QR code, em que a biometria é feita no celular):
+    - **Coletar no dispositivo de captura** (padrão): coleta apenas no aparelho que faz a biometria (ex.: o celular).
+    - **Coletar em todos os dispositivos**: coleta tanto no computador que iniciou a sessão quanto no celular que fez a biometria.
+
+## Como configurar pelo painel
+
+1. Autentique-se no painel de controle da sua instância.
+1. No menu lateral, clique em **Configurações**.
+1. Localize a seção **"Configurações de biometria"** e clique em **Editar**.
+![image](../../../../../../../images/rest-pki/core/geolocation-bio-settings.png)
+1. No campo **Tipo de captura de geolocalização**, escolha **Opcional** ou **Obrigatório** para ligar o recurso.
+1. Se desejar, ajuste a **Política de captura de geolocalização** (esse campo só aparece quando a captura está ligada).
+![image](../../../../../../../images/rest-pki/core/geolocation-values.png)
+1. Clique em **Salvar** para aplicar as configurações.
+
+> [!TIP]
+> Integrando via API? Você pode definir a geolocalização por sessão, sobrescrevendo o padrão configurado aqui — veja [Parâmetros de geolocalização](../index.md#geolocation).

docs.pt-br/articles/rest-pki/core/integration/bio-sessions/index.md

@@ -186,7 +186,7 @@ Ao iniciar uma sessão, você deve configurar os parâmetros que definem como o
 O `SubjectIdentifier` é um campo que vincula a sessão de biometria a uma pessoa específica que está utilizando o seu sistema.
 
 Para as sessões de cadastro biométrico e autenticação biométrica, o `SubjectIdentifier` é o identificador único relacionado à aquela pessoa que você deseja cadastrar ou autenticar no sistema de biometria.
-
+        
 Para as sessões anônimas, como Liveness e captura de documentos, esse identificador é indexado e poderá ser utilizado para encontrar o histórico de sessões com aquele identificador.
 
 > [!tip]
@@ -198,6 +198,27 @@ Caso queira aceitar apenas alguns tipos de identificadores específicos, você p
 - **FaceCaptureProvider:** Define qual tecnologia de captura será utilizada na sessão de biometria.
     - Atualmente o único provedor utilizado pelo sistema é o `FaceTecLiveness3d` 
 
+<a name="geolocation" />
+
+### Parâmetros de geolocalização
+
+O Rest PKI Core pode capturar a localização geográfica do dispositivo do usuário durante a sessão de biometria. O recurso está **desabilitado por padrão** e pode ser habilitado por sessão ou globalmente na configuração da subscription.
+
+> [!TIP]
+> Prefere configurar o padrão pelo painel? Veja [Configuração de geolocalização](configs/geolocation.md).
+
+- **`GeolocationCaptureType`**: Define o comportamento da captura.
+    - **`Disabled`** (padrão): Geolocalização não é coletada.
+    - **`Optional`**: O sistema tenta capturar a geolocalização, mas a sessão prossegue normalmente caso o usuário negue permissão ou a captura falhe.
+    - **`Required`**: A geolocalização é obrigatória. A sessão é interrompida se a captura não for concluída com sucesso.
+
+- **`GeolocationCapturePolicy`**: Define em quais dispositivos a geolocalização é coletada (relevante para sessões com QR code).
+    - **`CollectOnCaptureDevice`** (padrão): A geolocalização é capturada apenas no dispositivo que realiza a biometria (ex: o celular, nos fluxos com QR code).
+    - **`CollectOnAllDevices`**: A geolocalização é capturada em todos os dispositivos envolvidos na sessão — tanto no desktop que iniciou quanto no celular que realizou a captura.
+
+> [!NOTE]
+> A exibição (ou não) do prompt de permissão, e por quanto tempo o navegador lembra da permissão concedida, são definidos por cada navegador e fogem ao controle do Rest PKI Core. Em alguns navegadores, conceder a permissão de forma temporária (ex.: "Permitir desta vez" no Chrome) pode manter a localização disponível durante a sessão do navegador, mesmo quando a captura é opcional. Para detalhes sobre cada comportamento, consulte a documentação do respectivo navegador.
+
 ## Tipos de sessão
 
 * [Prova de vida (`Liveness`)](liveness.md)

docs.pt-br/articles/toc.md

@@ -112,6 +112,9 @@
 #### [Autenticação facial (Authentication)](rest-pki/core/integration/bio-sessions/authentication.md)
 #### [Identificação facial (Identification)](rest-pki/core/integration/bio-sessions/identification.md)
 #### [Captura de documento (IdentificationDocumentCapture)](rest-pki/core/integration/bio-sessions/id-capture.md)
+#### Configurações
+##### [Formatos de identificador](rest-pki/core/integration/bio-sessions/configs/subject-identifier-formats.md)
+##### [Geolocalização](rest-pki/core/integration/bio-sessions/configs/geolocation.md)
 ### [Referenciando arquivos](rest-pki/core/integration/file-referencing.md)
 ### [Webhooks](rest-pki/core/integration/webhooks.md)
 ### [Códigos de erro](rest-pki/core/integration/error-codes.md)