diff --git a/docs.en-us/articles/rest-pki/core/integration/bio-sessions/configs/geolocation.md b/docs.en-us/articles/rest-pki/core/integration/bio-sessions/configs/geolocation.md new file mode 100644 index 00000000..1f6aff3f --- /dev/null +++ b/docs.en-us/articles/rest-pki/core/integration/bio-sessions/configs/geolocation.md @@ -0,0 +1,4 @@ +# Geolocation configuration - Rest PKI Core + + +
\ No newline at end of file diff --git a/docs.en-us/articles/toc.md b/docs.en-us/articles/toc.md index 88e23156..d78bbea6 100644 --- a/docs.en-us/articles/toc.md +++ b/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) diff --git a/docs.pt-br/articles/rest-pki/core/integration/bio-sessions/configs/geolocation.md b/docs.pt-br/articles/rest-pki/core/integration/bio-sessions/configs/geolocation.md new file mode 100644 index 00000000..e198c705 --- /dev/null +++ b/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). \ No newline at end of file diff --git a/docs.pt-br/articles/rest-pki/core/integration/bio-sessions/index.md b/docs.pt-br/articles/rest-pki/core/integration/bio-sessions/index.md index a554cd21..85ebcb09 100644 --- a/docs.pt-br/articles/rest-pki/core/integration/bio-sessions/index.md +++ b/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` + + +### 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) diff --git a/docs.pt-br/articles/toc.md b/docs.pt-br/articles/toc.md index 8d294369..3d47b3c7 100644 --- a/docs.pt-br/articles/toc.md +++ b/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) diff --git a/images/rest-pki/core/geolocation-bio-settings.png b/images/rest-pki/core/geolocation-bio-settings.png new file mode 100644 index 00000000..30e35c64 Binary files /dev/null and b/images/rest-pki/core/geolocation-bio-settings.png differ diff --git a/images/rest-pki/core/geolocation-values.png b/images/rest-pki/core/geolocation-values.png new file mode 100644 index 00000000..8a5889ff Binary files /dev/null and b/images/rest-pki/core/geolocation-values.png differ