2022-03-23 10:11:25 +01:00
# Dex pour YunoHost
2022-03-23 09:15:13 +01:00
2022-03-23 10:11:25 +01:00
[![Niveau d'intégration ](https://dash.yunohost.org/integration/dex.svg )](https://dash.yunohost.org/appci/app/dex) ![](https://ci-apps.yunohost.org/ci/badges/dex.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/dex.maintain.svg)
[![Installer Dex avec YunoHost ](https://install-app.yunohost.org/install-with-yunohost.svg )](https://install-app.yunohost.org/?app=dex)
2022-03-23 09:15:13 +01:00
*[Read this readme in english.](./README.md)*
*[Lire ce readme en français.](./README_fr.md)*
2022-03-23 10:11:25 +01:00
> *Ce package vous permet d'installer Dex rapidement et simplement sur un serveur YunoHost.
2022-03-23 09:15:15 +01:00
Si vous n'avez pas YunoHost, regardez [ici ](https://yunohost.org/#/install ) pour savoir comment l'installer et en profiter.*
2022-03-23 09:15:13 +01:00
## Vue d'ensemble
2022-03-24 15:11:52 +01:00
Dex is an identity service that uses OpenID Connect to drive authentication for other apps.
This Yunohost package will install Dex and setup a canonical OpenID Connect provider for your Yunohost instance, based on the LDAP user base, that can then be used as an authentification server for other Yunohost apps.
2022-03-23 09:15:13 +01:00
2022-03-23 09:15:15 +01:00
### Features
2022-03-23 09:15:13 +01:00
2022-03-24 15:11:52 +01:00
- Fully working OpenID Connect authentification flow
- Interfaced with Yunohost's LDAP server
2022-03-23 09:15:13 +01:00
2022-04-22 17:54:11 +02:00
**Version incluse :** 2.31.1~ynh3
2022-03-23 10:11:25 +01:00
2022-03-23 09:15:13 +01:00
2022-03-23 09:15:15 +01:00
## Captures d'écran
2022-03-23 09:15:13 +01:00
2022-03-23 10:11:25 +01:00
![](./doc/screenshots/.DS_Store)
2022-03-23 11:04:22 +01:00
![](./doc/screenshots/Dex_screenshot.png)
2022-03-23 09:15:13 +01:00
## Avertissements / informations importantes
2022-03-31 15:52:40 +02:00
### Known limitations :
* Only tested on x86 architectures
* Dex only allows you to setup one OpenID Connect app at a time
* However, it's a working multi-instance app, so you can install it more than once
* Dex is only an OIDC provider, and user management will depend on the app using it as an OIDC provider
### To be used carefully :
* Changing URL will work but will require some settings change in the app using Dex as an OIDC provider
* Going to the URL will only let you see a "This is where Dex is installed." message
2022-03-23 09:15:13 +01:00
## Documentations et ressources
2022-03-23 10:11:25 +01:00
* Site officiel de l'app : https://dexidp.io
* Documentation officielle de l'admin : https://dexidp.io/docs/
* Dépôt de code officiel de l'app : https://github.com/dexidp/dex
* Documentation YunoHost pour cette app : https://yunohost.org/app_dex
* Signaler un bug : https://github.com/YunoHost-Apps/dex_ynh/issues
2022-03-23 09:15:13 +01:00
## Informations pour les développeurs
2022-03-23 10:11:25 +01:00
Merci de faire vos pull request sur la [branche testing ](https://github.com/YunoHost-Apps/dex_ynh/tree/testing ).
2022-03-23 09:15:13 +01:00
Pour essayer la branche testing, procédez comme suit.
```
2022-03-23 10:11:25 +01:00
sudo yunohost app install https://github.com/YunoHost-Apps/dex_ynh/tree/testing --debug
2022-03-23 09:15:15 +01:00
ou
2022-03-23 10:11:25 +01:00
sudo yunohost app upgrade dex -u https://github.com/YunoHost-Apps/dex_ynh/tree/testing --debug
2022-03-23 09:15:13 +01:00
```
2022-03-23 09:15:15 +01:00
**Plus d'infos sur le packaging d'applications :** https://yunohost.org/packaging_apps