france-connect · benratti · May 26, 2021 · May 26, 2021 · May 26, 2021 · May 27, 2021
diff --git a/README.md b/README.md
@@ -1 +1,6 @@
 # Documentation-FranceConnect-Plus
+
+Cette documentation regroupe l'ensemble des informations nécessaire à l'intégration de FranceConnect+, que ce soit en tant que Fournisseur d'identités de FranceConnect+ ou en tant que Fournisseur de services.
+
+- [documentation Fournisseur d'identités](/fi/docs-fi.md)
+- [documentation Fournisseur de services](/fs/README.md)
diff --git a/fs/README.md b/fs/README.md
@@ -0,0 +1,52 @@
+
+Documentation Fournisseur de Service
+
+---
+
+Vous souhaitez implémenter FranceConnect+ sur votre site? Vous êtes au bon endroit ! Cette documentation présente l'ensemble des informations à connaitre sur FranceConnect+
+
+# Préambule
+
+Cette documentation est à destination des Fournisseurs de Service souhaitant intégrer FranceConnect+. 
+FranceConnect+ met à disposition du Fournisseur de Service des identités de niveau de garantie eIDAS Susbtantiel et Elevé. 
+FranceConnect+ s'implémente sur une plateforme distincte de la plateforme FranceConnect qui reste dédiée aux identités de niveau de garantie "faible".
+
+# Je veux devenir fournisseur de services
+
+Vous vous poser des questions sur le fonctionnement général de FranceConnect+ et de son écosystème. Vous trouverez l'ensemble des réponses à vos questions dans cette section. 
+
+[Je veux devenir fournisseur de services](pilotage/README.md)
+
+# Je gère un projet d'intégration de FranceConnect+
+
+Vous allez ou vous avez lancé un projet pour devenir FranceConnect+ et vous souhaiter connaitre les différentes problématique d'intégration de FranceConnect+. Vous souhaitez avoir des informations précises sur les fonctionnement de FranceConnect+ pour gérer un projet d'intégration de FranceConnect+. Vous trouverez l'ensemble des réponses à vos questions dans cette section.
+
+[Je gère un projet d'intégration de FranceConnect+](projet/README.md)
+
+# J'intègre FranceConnect+ dans mon service en ligne
+
+## Je veux savoir comment fonctionne FranceConnect+
+
+- [Qu'est ce que OpenID Connect ?](technique/technique-oidc.md)
+- [Comment FranceConnect+ utilise OpenID Connect?](technique/technique-oidc-fc.md)
+
+## Je veux savoir comment utiliser FranceConnect+
+
+- [Comment accéder aux différents environnements de FranceConnect+ ?](technique/technique-env-fc.md)
+- [Comment utiliser les scopes OpenID Connect pour accéder aux données des utilisateurs ? ](technique/technique-scope-fc.md)
+- [Comment utiliser les niveaux de garantie eIDAS sur FranceConnect+ ?](technique/technique-eidas.md)
+- [Comment déconnecter un utilisateur de FranceConnect+ ?](technique/technique-deconnexion.md)
+- [Quelles sont les durées de vie des sessions et jetons de FranceConnect+ ?](technique/technique-sessions.md)
+ - [Comment gérer les erreurs renvoyées par FranceConnect+ ?](technique/technique-erreurs.md)
+
+
+## Je veux connaitre les règles d'intégration du bouton dans mon service
+
+- [Comment intégrer le bouton FranceConnect+ à mon service ?](technique/technique-boutons-fc.md)
+
+## Glossaire
+
+Vous êtes perdu dans l'ensemble des termes techniques présents dans cette documentation ? Nous avons notre [glossaire](technique/technique-glossaire.md) qui est là pour vous aider. 
+
+
+
diff --git a/fs/diagrams/diagram-sequence-oauth.mmd b/fs/diagrams/diagram-sequence-oauth.mmd
@@ -0,0 +1,15 @@
+```mermaid
+sequenceDiagram
+    autonumber
+    participant RO as Resource Owner 
+    participant C as Client
+    participant AS as Authorization Server
+    participant RS as Resource Server
+
+    C->>RO: Authorization Request
+    RO-->>C: Authorization Grant
+    C->>AS: Authorization Grant
+    AS-->>C: Access Token
+    C->>RS: Access Token
+    RS-->>C: Protected Resource
+```
diff --git a/fs/diagrams/diagram-sequence-oauth.png b/fs/diagrams/diagram-sequence-oauth.png
diff --git a/fs/docs-fs.md b/fs/docs-fs.md
diff --git a/fs/images/projet/projet-bouton-eidas.png b/fs/images/projet/projet-bouton-eidas.png
diff --git a/fs/images/technique/guidelines-fc+.png b/fs/images/technique/guidelines-fc+.png
diff --git a/fs/images/technique/technique-guidelines-fc+-dimensions.png b/fs/images/technique/technique-guidelines-fc+-dimensions.png
diff --git a/fs/images/technique/technique-guidelines-fc+-lien.png b/fs/images/technique/technique-guidelines-fc+-lien.png
diff --git a/fs/images/technique/technique-guidelines-fc+-ne-pas-faire.png b/fs/images/technique/technique-guidelines-fc+-ne-pas-faire.png
diff --git a/fs/images/technique/technique-guidelines-fc+-position.png b/fs/images/technique/technique-guidelines-fc+-position.png
diff --git a/fs/images/technique/technique-guidelines-fc+-themes.png b/fs/images/technique/technique-guidelines-fc+-themes.png
diff --git a/fs/integration/integration-oidc.md b/fs/integration/integration-oidc.md
@@ -0,0 +1,24 @@
+
+
+---
+
+# Qu'est ce que le protocole OpenID Connect ?
+## Introduction
+
+Le protocole OpenID Connect est au cœur du fonctionnement de FranceConnect+. C'est une couche d'identification basée sur protocole OAuth 2.0. Il permet à des Clients (ici, les Fournisseur de Service) d'accéder à l'identité des Utilisateurs finaux (les internautes) par l'intermédiaire d'un serveur d'autorisation (ici, les Fournisseurs d'Identité).
+
+La spécification du protocole se trouve sur http://openid.net/connect/.
+
+Pour une référence d'implémentation OpenID Connect voici le lien : https://openid.net/specs/openid-connect-core-1_0.html#CodeFlowAuth
+
+## Les flux standards
+
+Le protocole OpenID Connect définit 3 appels REST faits par le client, et 4 endpoints (un du côté client, et trois du côté provider).
+
+En amont, le client s'inscrit (en général manuellement) auprès du provider. Il lui fournit une URL de callback (l'URL du client vers lequel l'internaute est redirigé une fois authentifié), aussi appelée "callback endpoint". En retour le provider donne au client un client ID et un client secret.
+
+Lorsque l'internaute clique sur le bouton d'authentification du client, le flux est le suivant :
+
+1. Le client fait une redirection vers le "authorization endpoint" du provider avec son client id et son url de callback. Le provider redirige alors l'internaute vers sa mire d'authentification. Si l'internaute se loggue correctement, le provider renvoie un code d'autorisation au client.
+2. Le client fait un appel Web service vers le "token endpoint" du provider avec le code d'autorisation reçu, et authentifie cette requête avec son client id et son client secret. Le provider retourne un access token (une chaîne de caractères encodée en base64), un id token (sous la forme d'un Json Web Token), et parfois un refresh token (une chaîne de caractères en base64).
+3. Le client fait un appel Web service vers le "userInfo endpoint" du provider avec l'access token reçu, et le provider renvoie les informations de l'internaute au client.
diff --git a/fs/pilotage/README.md b/fs/pilotage/README.md
@@ -0,0 +1,53 @@
+[Documentation Fournisseur](../README.md) > [Je veux devenir Fournisseur de Service](README.md)
+
+---
+
+# Je veux devenir Fournisseur de Service 
+
+Vous souhaitez devenir Fournisseur de Service pour FranceConnect+, voici les questions à vous poser.
+
+### Quelles sont les étapes pour devenir Fournisseur de Service ?
+
+Pour devenir fournisseur de service de FranceConnect+, vous devez réaliser les actions suivantes : 
+
+1. vérifier les conditions d'éligibilité; 
+2. demander votre habilitation;
+3. réaliser votre intégration;
+4. faire qualifier votre intégration;
+5. passer en production. 
+
+[Plus d'informations](pilotage-etapes.md)
+
+### Quels sont les différents acteurs que je dois faire intervenir dans mon organisation pour devenir Fournisseur de Service ?
+
+Pour devenir fournisseur de service, vous devez faire intervenir des acteurs de votre organisation comme le responsable de traitement, votre délégué à la protection des données, votre RSSI ou votre responsable technique.
+
+
+[Plus d'informations](pilotage-demarches-acteurs.md)
+
+
+### Quelles sont les différences entre FranceConnect et FranceConnect+ ?
+
+La principale différences entre FranceConnect et FranceConnect+ est le niveau de garantie eIDAS supporté par la plateforme.
+
+ [Plus d'informations](pilotage-differences-fc-fc+.md)
+
+ ### L'usage de FranceConnect+ est-il payant ?
+
+L'usage de FranceConnect+ n'entraine aucune compensation financière entre la DINUM et le fournisseur de service. Cependant, il peut nécessiter une relation contractuel avec les fournisseurs d'identités et entrainer une facturation de l'usage des identités. 
+
+[Plus d'informations](pilotage-facturation.md)
+
+### Quels sont les fournisseurs d'identités disponible sur FranceConnect+ ? 
+
+La liste des fournisseurs d'identité est disponible sur le site internet de FranceConnect+. Il s'agit exclusivement de fournisseurs d'identité qualifié par l'ANSSI pour les niveau de garantie substantiel et élevé.
+
+[Plus d'informations](piloge-fi.md)
+
+### Je suis déjà Fournisseur de Service pour FranceConnect, que dois je faire en plus pour devenir Fournisseur de Service pour FranceConnect+ ?
+
+Si vous êtes fournisseur de service pour FranceConnect et que vous souhaitez devenir fournisseur de service pour FranceConnect+, vous devez : 
+- réaliser une nouvelle demande d'habilitation via datapass et - - réaliser quelques adaptions techniques pour intégrer les spécificités des FranceConnect+
+- demander une qualification par l'équipe FranceConnect
+
+[Plus d'informations](pilotage-integrer-fc+-apres-fc.md)
diff --git a/fs/pilotage/piloge-fi.md b/fs/pilotage/piloge-fi.md
@@ -0,0 +1,16 @@
+[Documentation Fournisseur](../README.md) > [Je veux devenir Fournisseur de Service](../README.md#je-veux-devenir-fournisseur-de-service) > Quels sont les fournisseurs d'identités disponible sur FranceConnect+ ?
+
+---
+
+# Quels sont les fournisseurs d'identités disponible sur FranceConnect+ ? 
+
+La liste des fournisseurs d'identité est disponible sur le site internet de [FranceConnect+](https://franceconnect.gouv.fr/france-connect-plus). Il s'agit exclusivement de fournisseurs d'identité qualifié par l'ANSSI pour les niveaux de garantie substantiel et élevé. 
+
+En complément des fournisseurs d'identité, FranceConnect+ propose également une connection à la passerelle européenne eIDAS, permettant l'accès à votre fournisseu de service à des citoyens des autres états membres européens. Ceci est une obligation pour les fournisseurs de service publics utilisant FranceConnect+ et optionnel pour les fournisseurs de service privés. 
+
+
+--- 
+
+Voir aussi : 
+
+- [Qu'est ce qu'eIDAS et quels sont les niveaux de garantie de FranceConnect+ ?](../projet/projet-niveau-eidas.md)
diff --git a/fs/pilotage/pilotage-demarches-acteurs.md b/fs/pilotage/pilotage-demarches-acteurs.md
@@ -0,0 +1,46 @@
+[Documentation Fournisseur](../README.md) > [Je veux devenir Fournisseur de Service](README.md) > Quels sont les acteurs à impliquer dans l'intégration de FranceConnect+ ?
+
+---
+
+# Quels sont les acteurs à impliquer dans l'intégration de FranceConnect+ ?
+
+Pour devenir Fournisseur de Service de FranceConnect+, il est nécessaire de designé des personnes remplissants les rôles suivants : Responsable de traitement, Délégué à la protection des données, Responsable technique, Responsable de la Sécurité du Système d'Information. 
+
+Il vous sera demandé lors de la demande d'habilitation à FranceConnec+ d'identifier les personnes ayant ces responsabilités. 
+
+Les acteurs à impliquer sont les suivants : 
+
+- Le responsable de traitement
+- le délégué à la protection des données
+- le responsable technique
+- le responsable de la sécurité dur système d'information 
+
+
+## Responsable de traitement
+
+Le responsable du traitement des données est la personne physique ou morale qui, seul ou conjointement avec d’autres, détermine les finalités et les moyens du traitement des données à caractère personnel. Seule une personne appartenant à l’organisme demandeur peut être renseignée. ([plus d’infos](https://www.cnil.fr/fr/definition/responsable-de-traitement))
+
+## Délégué à la protection des données
+
+C'est la personne qui s’assure que l’organisation protège convenablement les données à caractère personnel, conformément à la législation en vigueur. C'est généralement une personne appartenant à l’organisme demandeur. ([plus d’infos](https://www.cnil.fr/fr/designation-dpo))
+
+##  Responsable technique
+
+C'est la personne qui est reponsable de la mise en oeuvre du fournisseur de service de FranceConnect+. Cette personne recevra les accès techniques par mail. Le numéro de téléphone doit être un numéro de téléphone mobile. Il sera utilisé pour envoyer un code d’accès. Le responsable technique peut être le contact technique de votre prestataire. 
+
+## Responsable de la Sécurité du Système d'Information 
+
+Le Responsable de la sécurité des systèmes d’information (RSSI)
+assure le pilotage de la démarche de cybersécurité sur un périmètre
+organisationnel et/ou géographique au sein de l’organisation. Il définit
+ou décline, selon la taille de l’organisation, la politique de sécurité des
+systèmes d’information (prévention, protection, détection, résilience,
+remédiation) et veille à son application. Il assure un rôle de conseil,
+d’assistance, d’information, de formation et d’alerte, en particulier
+auprès des directeurs métiers et/ou de la direction de son périmètre.
+
+---
+
+Voir aussi : 
+
+* [Quelles sont les étapes pour devenir Fournisseur de Service ? ](pilotage-etapes.md)
diff --git a/fs/pilotage/pilotage-differences-fc-fc+.md b/fs/pilotage/pilotage-differences-fc-fc+.md
@@ -0,0 +1,24 @@
+[Documentation Fournisseur](../README.md) > [Je veux devenir Fournisseur de Service](README.md) > Quelles sont les différences entre FranceConnect et FranceConnect+ ?
+
+---
+
+# Quelles sont les différences entre FranceConnect et FranceConnect+ ?
+
+La principale différences entre FranceConnect et FranceConnect+ est le niveau de garantie eIDAS supporté par la plateforme. Pour rappel, le règlement eIDAS prévoit trois niveau de garantie :
+
+> - Faible : à ce niveau, l’objectif est simplement de réduire le risque d’utilisation abusive ou d’altération de l’identité ;
+> - Substantiel : à ce niveau, l’objectif est de réduire substantiellement le risque d’utilisation abusive ou d’altération de l’identité ;
+> - Élevé : à ce niveau, l’objectif est d’empêcher l’utilisation abusive ou l’altération de l’identité.
+
+[[plus d'infos](https://www.ssi.gouv.fr/administration/reglementation/confiance-numerique/le-reglement-eidas/)]
+
+
+La plateforme FranceConnect supporte uniquement le niveau de garantie faible. C'est la plateforme FranceConnect+ qui assurent les niveaux de garantie supérieur, c'est à dire les niveaux de garantie Substantiel et Élevé. 
+
+---
+
+Voir aussi : 
+
+* [Qu'est ce qu'eIDAS et quels sont les niveaux de garantie de FranceConnect+ ?](../projet/projet-niveau-eidas.md)
+* [Comment effectuer ma demande d'habilitation pour FranceConnect+ ?](../projet/projet-datapass.md)
+
diff --git a/fs/pilotage/pilotage-etapes.md b/fs/pilotage/pilotage-etapes.md
@@ -0,0 +1,39 @@
+[Documentation Fournisseur](../README.md) > [Je veux devenir Fournisseur de Service](README.md) > Quelles sont les étapes pour devenir Fournisseur de Service ? 
+---
+
+# Quelles sont les étapes pour devenir Fournisseur de Service ? 
+
+### 1. Vérifier les conditions d'éligibilité 
+
+Vous consultez les conditions d'éligibilité à FranceConnect. Les conditions juridiques, de sécurité et de qualité de service sont détaillées dans nos 
+<a href="https://partenaires.franceconnect.gouv.fr/cgu" rel="noreferrer noopener" target="_blank" title="Conditions Générales d'Utilisation FranceConnect - nouvelle fenêtre">conditions générales d'utilisations</a>. Le cadre d'implémentation et d'intégration est détaillé dans nos [spécifications ergonomiques](../technique/technique-boutons-fc.md).# Quelles sont les étapes pour devenir Fournisseur de Service ? 
+
+
+### 2. Demander votre habilitation 
+
+Vous soumettez une demande d'habilitation  via <a href="https://datapass.api.gouv.fr/franceconnect" rel="noreferrer noopener" target="_blank" title="Datapass FranceConnect - nouvelle fenêtre">le formulaire datapass FranceConnect</a> et vous transmettez toutes les informations nécessaires à la validation de votre demande (respect du RGPD, contact du responsable technique, niveau de garantie eIDAS souhaité, données d'identité recueillies, etc). Votre demande est validée par le service juridique de la DINUM dans un délai moyen de 5 jours ouvrés.
+
+### 3. Réaliser votre intégration
+
+Si votre demande est acceptée, vous devez faire une demande pour pouvoir accéder à l'environnement d'intégration FranceConnect+. Celui-ci vous permettra de réaliser vos développements. Pour faire votre demande, il est nécessaire d'utiliser la démarche en ligne suivante : https://www.demarches-simplifiees.fr/commencer/demande-de-creation-d-un-fs-fc-plus. Veillez à bien préciser lors de votre demande concerne l'environnement d'intégration FranceConnect+
+
+### 4. Faire qualifier votre intégration
+
+Vous devez présentez vos développements pour une qualification par l'équipe FranceConnect. La durée de cette phase de qualification dépend du respect des prérequis (techniques, sécurité, fonctionnels, UX...). N'hésitez pas à soumettre vos maquettes de parcours en amont pour une pré-qualification fonctionnelle et UX anticipée. 
+
+Vous retrouvez l'ensemble des pré-requis dans la section *Recette interne* de la démarche simplifiée.
+
+Pour réaliser votre demande de qualification, vous devez utiliser la démarche en ligne suivante : https://www.demarches-simplifiees.fr/commencer/demande-qualification-fs-fcplus. Dans un premier temps, vous devez déjà réaliser par vous même une recette de votre intégration. Une fois votre recette réalisée, vous pouvez demander votre qualification par les équipes FranceConnect.
+
+
+### 5. Passer en production 
+
+Si votre implémentation est validée par notre équipe, vous recevez vos secrets pour passer en production. Pour cela, il est nécessaire d'utiliser la démarche en ligne suivante pour les demander : [https://www.demarches-simplifiees.fr/commencer/demande-de-creation-d-un-fs-fc-plus](https://www.demarches-simplifiees.fr/commencer/demande-de-creation-d-un-fs-fc-plus). Veillez à bien préciser lors de votre demande concerne l'environnement de production FranceConnect+.
+
+---
+
+Voir aussi : 
+- [Quels sont les acteurs à impliquer dans l'intégration de FranceConnect+ ?](pilotage-demarches-acteurs.md)
+- [Comment effectuer ma demande d'habilitation pour FranceConnect+ ?](../projet/projet-datapass.md)
+- [Quelles sont les différences entre FranceConnect et FranceConnect+ ?](./pilotage-differences-fc-fc%2B.md)
+- [Je suis déjà Fournisseur de Service pour FranceConnect, que dois je faire en plus pour devenir Fournisseur de Service pour FranceConnect+ ?](./pilotage-integrer-fc%2B-apres-fc.md)
diff --git a/fs/pilotage/pilotage-facturation.md b/fs/pilotage/pilotage-facturation.md
@@ -0,0 +1,25 @@
+[Documentation Fournisseur](../README.md) > [Je veux devenir Fournisseur de Service](README.md) > L'usage de FranceConnect+ est-il payant?
+
+---
+
+# L'usage de FranceConnect+ est-il payant?
+
+L'usage de FranceConnect+ n'entraine aucune compensation financière entre la DINUM et le fournisseur de service. Cependant, il peut nécessiter une relation contractuel avec les fournisseurs d'identités et entrainer une facturation de l'usage des identités. 
+
+### Usage par les fournisseurs de service publics
+
+L'usage de FranceConnect+ est gratuit pour l'ensemble des fournisseurs de service public, quelque soit les fournisseurs d'identité utilisés par les usagers pour se connecter. 
+
+### Usage par les fournisseurs de services privés
+
+Pour les fournisseurs de service privé, l'usage de FranceConnect+ nécessite une contractualisation avec l'ensemble des fournisseurs d'identité privés. Cela peut entrainer une facturation dépendant de la consommation des identités pour les fournisseurs de service. Dans ce cas, c'est la DINUM qui est en charge de fournir les volumétrie d'usages des fournisseurs d'identités par le fournisseur de service. 
+
+L'usage des fournisseurs d'identité public est quant à lieu gratuit et ne nécessite pas de contractualisation entre le fournisseur de service et le fournisseur d'identité. 
+
+**En bref :** L'usage de FranceConnect+ est payant pour les fournisseurs de service privés qui utilisent des fournisseurs de d'identité privés. 
+
+--- 
+
+Voir aussi : 
+
+* [Quelles sont les différences entre FranceConnect et FranceConnect+ ?](../pilotage/pilotage-differences-fc-fc%2B.md)