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

# Autenticació Android: inici ràpid

> Prepara l'autenticació Android amb Didit: inici de sessió allotjat, validació de callbacks, sessions segures i enllaços a verificació i monitoratge.

> [!WARNING]
>
> L'autenticació és nova: **DiditAuth for Android** depèn de la versió. Les coordenades de distribució, les versions i les signatures de crida no es confirmen aquí. No instal·lis un paquet suposat ni utilitzis l'SDK de verificació d'identitat com a SDK d'autenticació.

## Prepara l'aplicació

1. Confirma que l'autenticació està activada per a la teva aplicació de Didit i copia'n l'origen d'inici de sessió (`https://<slug>.auth.didit.me`, o `<slug>.sandbox.auth.didit.me` per al sandbox) des de la consola.
2. Registra una URL de callback exacta compatible amb la teva aplicació i el seu entorn d'execució. Valida la propietat dels enllaços d'aplicació; no suposis que s'accepten esquemes d'URL personalitzats arbitraris.
3. Mantén separada la configuració de sandbox i de producció, incloent-hi la gestió dels callbacks i les credencials emmagatzemades.
4. Tria el mapatge estable de la identitat de la persona abans de connectar la verificació o el monitoratge.

Utilitza una pestanya del navegador del sistema per a l'inici de sessió allotjat i valida l'enllaç d'aplicació de retorn. Les claus d'accés natives requereixen el domini configurat de la part confiant i el flux de credencials de la plataforma.

## Implementa el flux allotjat

Obre una pestanya del navegador del sistema amb l'URL `{origin}/sign-in`. Proporciona un `state` aleatori i nou, un desafiament PKCE S256 i el teu `redirect_uri` registrat. Mantén el verificador a l'aplicació només per a aquest intent. La [guia d'inici ràpid de JavaScript](https://docs.didit.me/ca/authentication/quickstarts/javascript.md) mostra el protocol subjacent; en codi nadiu, utilitza la criptografia i la gestió d'URL de la plataforma en lloc de les variables globals del navegador.

En rebre el callback, verifica el state, la durada de la transacció i el destí del callback abans d'intercanviar el codi d'un sol ús a `token/`. Utilitza el verificador original i l'URI de redirecció exacte. Cancel·lar o tancar el navegador no és un inici de sessió satisfactori.

Emmagatzema els tokens de renovació en un emmagatzematge xifrat protegit per la plataforma; mai en un fitxer de preferències en text pla, ni en analítica o registres de fallades. Valida la sessió actual amb `GET session/` i el token Bearer de l'usuari final. Serialitza la renovació, substitueix els dos tokens alhora i esborra l'estat específic de l'usuari en tancar la sessió. Consulta [tokens i JWKS](https://docs.didit.me/ca/authentication/tokens-and-jwks.md) per al contracte de la sol·licitud i el comportament de reutilització dels tokens de renovació.

## Vista prèvia de l'SDK nadiu

Està previst que els mòduls nadius d'autenticació ofereixin inici de sessió, accés a la sessió actual, obtenció de tokens, tancament de sessió i augment del nivell d'autenticació, amb senyals automàtics del dispositiu. Les claus d'accés natives i l'emmagatzematge protegit de tokens formen part d'aquesta versió. Les API d'embolcall seguiran els seus contractes de plataforma publicats; no copiïs arguments de constructor ni signatures de mètodes suposats d'un exemple de disseny.

Fins que el mòdul es publiqui, mantén el seu adaptador desactivat o utilitza una implementació revisada del protocol allotjat per a la teva aplicació habilitada. No anunciïs un inici ràpid d'autenticació nadiu que funcioni només amb la instal·lació del paquet.

## Connecta la verificació i el monitoratge

El teu backend deriva `vendor_data` de la persona autenticada. Crea sessions de verificació o emet tokens de monitoratge amb abast per a aquesta persona. Retorna a l'aplicació només la credencial de sessió o el token amb abast; la clau d'API es queda al servidor.

Utilitza l'[SDK de verificació d'Android](https://docs.didit.me/ca/integration/native-sdks/android-sdk.md) quan necessitis la verificació d'identitat. Segueix [l'enviament de transaccions de l'SDK](https://docs.didit.me/ca/transaction-monitoring/sdk-transaction-submission.md) per al suport de monitoratge a la teva plataforma. Tracta l'inici de sessió, la verificació i les decisions sobre transaccions per separat.

## Verifica la integració

Prova el retorn a una aplicació aturada (iniciada en fred), les transicions a segon pla i en primer pla, la cancel·lació del navegador, un callback que no coincideix, la reutilització del codi, la caducitat del token, la renovació concurrent, MFA, el tancament de sessió i l'inici de sessió com a un altre usuari. Prova el registre i l'inici de sessió amb claus d'accés en dispositius compatibles quan aquesta versió estigui disponible. Una comprovació només en dispositiu continua sense verificar fins que s'executi a la plataforma de destinació.


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