Saltar al contingut principal
L’autenticació és nova: DiditAuth per a iOS depèn de la versió publicada. Les coordenades de distribució, les versions i les signatures de crida no es confirmen aquí. No instal·lis un paquet suposat ni utilitzis el SDK de verificació d’identitat com a SDK d’autenticació.

​
Prepara l’aplicació

  1. Confirma que l’autenticació està habilitada 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 a sandbox) des de la consola.
  2. Registra una URL de callback exacta que sigui compatible amb la teva aplicació i el seu entorn d’execució. Valida la titularitat dels app links; no suposis que s’accepten esquemes d’URL personalitzats arbitraris.
  3. Mantén separada la configuració de sandbox i de producció, inclosa la gestió dels callbacks i les credencials emmagatzemades.
  4. Tria l’assignació estable de la persona abans de connectar la verificació o el monitoratge.
Utilitza la sessió d’autenticació del sistema per a l’inici de sessió allotjat. Planifica junts la gestió nativa de les claus d’accés i el domini de la part confiant. Un WebView no substitueix el flux d’autenticació del sistema.

​
Implementa el flux allotjat

Obre una sessió del navegador d’autenticació del sistema amb la URL {origin}/sign-in. Proporciona un state aleatori i nou, un desafiament PKCE S256 i el teu redirect_uri registrat. Guarda el verificador a la teva aplicació només per a aquest intent. La guia d’inici ràpid de JavaScript 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 la destinació 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 de credencials protegit per la plataforma; mai en un fitxer de preferències sense protecció, ni en analítiques 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 per al contracte de la petició i el comportament en cas de reutilització del token de renovació.

​
Vista prèvia de la versió del SDK nadiu

Els mòduls nadius d’autenticació estan previstos per oferir inici de sessió, accés a la sessió actual, obtenció de tokens, tancament de sessió i autenticació reforçada, amb senyals automàtics del dispositiu. Les claus d’accés nadiues i l’emmagatzematge protegit de tokens formen part d’aquesta versió. Les APIs d’embolcall seguiran els seus contractes de plataforma publicats; no copiïs constructors 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 nadiu d’autenticació que funcioni només per 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 limitats per a aquesta persona. Retorna a la teva aplicació només la credencial de sessió o el token limitat; la clau d’API es queda al servidor. Utilitza el SDK de verificació per a iOS quan necessitis la verificació d’identitat. Segueix l’enviament de transaccions amb el SDK per al suport de monitoratge a la teva plataforma. Tracta l’inici de sessió, la verificació i les decisions sobre transaccions de manera separada.

​
Verifica la integració

Prova el retorn a una aplicació tancada, les transicions a segon pla i en primer pla, la cancel·lació del navegador, un callback que no coincideix, la reproducció d’un codi, la caducitat dels tokens, la renovació concurrent, MFA, el tancament de sessió i l’inici de sessió amb 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 queda sense verificar fins que s’executi a la plataforma objectiu.
Darrera modificació el 7 de novembre del 2026