oidc client

@axa-fr/oidc-client

• Acerca de
• Empezando
• Ejecutar las demostraciones
• Cómo funciona
• Paquetes
  • @axa-fr/oidc-client
  • @axa-fr/react-oidc
  • @axa-fr/svelte-oidc : estamos buscando contribuyentes
  • @axa-fr/vue-oidc : estamos buscando contribuyentes
  • @axa-fr/angular-oidc : estamos buscando contribuyentes
• Preguntas frecuentes
• Migraciones
• Contribuir

Acerca de

@axa-fr/oidc-client la biblioteca más ligera y segura para administrar la autenticación con OpenID Connect (OIDC) y el protocolo OAuth2. Es compatible con todos los proveedores de OIDC. @axa-fr/oidc-client es una biblioteca JavaScript pura. Funciona con cualquier marco o biblioteca de JavaScript. @axa-fr/react-doidc es para react (compatible next.js, etc.), esperamos que pronto proporcione uno para Vue , Angular y Svelte .

Población:

• Pruebe la demostración de react en https://black-rock-0dc6b0d03.1.azurestaticapps.net/ (más avanzado)
• Pruebe la demostración pura de JavaScript en https://icy-glacier-004ab4303.2.azurestaticapps.net/

@axa-fr/oidc-client es:

• Seguro :
  • Con la demostración de prueba de posesión (DPOP), su Access_Token y Refresh_Token no se pueden usar fuera del contexto de su navegador (gran protección)
  • Con el uso del trabajador de servicio, sus tokens (refresh_token y/o access_token) no son accesibles para el código del cliente JavaScript (si sigue buenas prácticas desde la sección FAQ )
  • OIDC Uso de la subvención de credencial del código del lado del cliente solo con PKCE
• Ligero : el tamaño desempaquetado en NPM es de 274 kb , minificado de 61.1kB , minificado+estadísticas de PKG de 16.8kB a través de BundlePhobia.com
• Simple
  • Refresh_token y access_token se actualizan automáticamente en segundo plano
  • Con el uso del trabajador de servicio, no necesita inyectar el access_token en cada búsqueda, solo debe configurar el archivo OIDCtrustedDomains.js
• Autenticación múltiple :
  • Puede autenticarse muchas veces al mismo proveedor con un alcance diferente (por ejemplo, puede adquirir un nuevo alcance de 'pago' para un pago)
  • Puede autenticarse con varios proveedores diferentes dentro del mismo sitio web de SPA (aplicación de una sola página)
• Flexible :
  • Trabaje con trabajador de servicio (más seguro) y sin un navegador más antiguo (menos seguro).
  • Puede deshabilitar el trabajador de servicios si lo desea (pero menos seguro) y simplemente use SessionStorage o LocalStorage Mode.

Funciona perfectamente bien con:

• Auth0
• Servidor de identidad de duende
• Servidor de identidad 4
• Azure AD
• Google
• AWS
• Cloak
• etc., todos los proveedores de OIDC

Empezando

Comenzando con @axa-fr/oidc-client

npm install @axa-fr/oidc-client --save

# To install or update OidcServiceWorker.js file, you can run
node ./node_modules/@axa-fr/oidc-client/bin/copy-service-worker-files.mjs public

# If you have a "public" folder, the 2 files will be created :
# ./public/OidcServiceWorker.js <-- will be updated at each "npm install"
# ./public/OidcTrustedDomains.js <-- won't be updated if already exist 

Advertencia

Si usa el modo Service Worker , el archivo OidcServiceWorker.js siempre debe estar actualizado con la versión de la biblioteca. Puede configurar un script Postinstall en su archivo package.json para actualizarlo en cada instalación de NPM. Por ejemplo :

  "scripts" : {
    ...
    "postinstall" : " node ./node_modules/@axa-fr/oidc-client/bin/copy-service-worker-files.mjs public "
  },

Más documentación:

• @axa-fr/oidc-client

Comenzando con @axa-fr/react-doidc

npm install @axa-fr/react-oidc --save

# To install or update OidcServiceWorker.js file, you can run
node ./node_modules/@axa-fr/react-oidc/bin/copy-service-worker-files.mjs public

# If you have a "public" folder, the 2 files will be created :
# ./public/OidcServiceWorker.js <-- will be updated at each "npm install"
# ./public/OidcTrustedDomains.js <-- won't be updated if already exist 

Advertencia

Si usa el modo de trabajo de servicio, el archivo OIDCServiceWorker.js siempre debe estar actualizado con la versión de la biblioteca. Puede configurar un script Postinstall en su archivo paquete.json para actualizarlo en cada instalación de NPM. Por ejemplo :

  "scripts" : {
    ...
    "postinstall" : " node ./node_modules/@axa-fr/react-oidc/bin/copy-service-worker-files.mjs public "
  },

Más documentación:

• @axa-fr/react-oidc

Ejecutar las demostraciones

git clone https://github.com/AxaFrance/oidc-client.git

cd oidc-client
pnpm install

# oidc client demo
cd examples/oidc-client-demo
pnpm install
pnpm start
# then navigate to http://localhost:5174

# react vite demo
cd examples/react-oidc-demo
pnpm install
pnpm start
# then navigate to http://localhost:4200

# react NextJS demo
cd examples/nextjs-demo
pnpm install
pnpm run dev
# then navigate to http://localhost:3001 

Cómo funciona

El trabajador de servicio Catch Access_token y Refresh_token que nunca será accesible para el cliente.

Estos componentes encapsulan el uso de " @axa-fr/oidc-client " para ocultar la complejidad del flujo de trabajo. Internamente para " @axa-fr/react-oidc ", la API de la historia nativa se usa para ser la biblioteca de enrutadores agnóstico.

Más información sobre OIDC:

• Francés: Augmentez la Sécurité et la simplicité de votre système d'Ingage Openid Connect
• Inglés: aumente la seguridad y la simplicidad de su sistema de información con OpenID Connect
• Inglés: YouTube React -idc Introducción
• French: YouTube React -idc Introducción

Preguntas frecuentes

• Preguntas frecuentadas FAQ

Migraciones

• Migrar de guide V3 a V4
• Migrar de guide V3 a V5
• Migrar de guide V4 a V5
• Migrar de guide V5 a V6
• Migrar de guide V6 a V7

Contribuir

• Cómo ejecutar la solución y contribuir
• Respeta nuestro código de conducta