Skip to content

Commit

Permalink
Merge pull request #1384 from betagouv/20240924_proconnect
Browse files Browse the repository at this point in the history
replace agentconnect by proconenct
  • Loading branch information
Isalafont authored Oct 9, 2024
2 parents ee4f25f + 45c98f6 commit d370b40
Show file tree
Hide file tree
Showing 4 changed files with 36 additions and 47 deletions.
28 changes: 14 additions & 14 deletions _data/api/agent-connect.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: AgentConnect
tagline: Simplifiez le quotidien des agents publics de l'État en leur permettant d’utiliser un même identifiant et mot de passe pour accéder à leurs services en ligne.
external_site: https://agentconnect.gouv.fr/
title: ProConnect
tagline: Le solution officielle qui vous identifie en tant que professionnel.
external_site: https://proconnect.gouv.fr/
is_open: -1 # -1 means API not open
datapass_link: https://datapass.api.gouv.fr/agent-connect-fs
access_page:
- who:
- Un particulier
is_eligible: -1
description: |
Seules les organisations sont habilitées à utiliser l'API AgentConnect ou intégrer le bouton AgentConnect.
Seules les organisations sont habilitées à utiliser l'API ProConnect ou intégrer le bouton ProConnect.
<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
Expand All @@ -21,7 +21,7 @@ access_page:
description: |
<NextSteps />
<QuestionTree tree='france-connected-api' question='agentConnect' />
<QuestionTree tree='france-connected-api' question='ProConnect' />
producer: dinum
keywords:
- Authentification
Expand All @@ -36,31 +36,31 @@ keywords:
themes:
- Administration
contact_link: [email protected]
doc_tech_external: https://github.com/france-connect/Documentation-AgentConnect/blob/main/doc_fs.md
doc_tech_external: https://github.com/numerique-gouv/proconnect-documentation/blob/main/doc_fs.md
visits_2019: 4000
#uptime:
last_update: 27/08/2024
---

L’API AgentConnect permet à des ministères (administrations centrales, services déconcentrés) des collectivités territoriales et à des opérateurs de l’État d’ajouter un bouton de connexion AgentConnect pour identifier les agents utilisateurs de leurs applications métiers en ligne à partir de données d’identité fiables.
L’API ProConnect permet à des ministères (administrations centrales, services déconcentrés) des collectivités territoriales, des opérateurs de l’État ou à des entreprises d’ajouter un bouton de connexion ProConnect pour identifier les professionnels en ligne à partir de données d’identité fiables.

### À quoi sert AgentConnect ?
### À quoi sert ProConnect ?

AgentConnect s’adresse aux ministères (administrations centrales, services déconcentrés), aux collectivités territoriales ainsi qu'aux opérateurs de l’État.
Les administrations partenaires fournissent des identités qui permettent aux agents de s'identifier sur les sites qui ont implémenté le bouton AgentConnect.
ProConnect s’adresse aux organisations.
Les organisations partenaires fournissent des identités qui permettent aux agents de s'identifier sur les sites qui ont implémenté le bouton ProConnect.

### 🔎 À quoi ressemble le parcours ?

1. Je suis agent de l’État,
1. Je suis pro,
2. Je souhaite accéder à une application métier,
3. Je clique sur le bouton AgentConnect de l'application métier,
3. Je clique sur le bouton ProConnect de l'application métier,
4. Je rentre mon adresse email,
5. AgentConnect me redirige vers une page de connexion pour saisir mon identifiant et mot de passe,
5. ProConnect me redirige vers une page de connexion pour saisir mon identifiant et mot de passe,
6. La connexion est établie

### Les données disponibles via l'API

Utiliser l'API AgentConnect pour identifier les agents utilisateurs de votre site permet d'accéder à **l'identité pivot**.
Utiliser l'API ProConnect pour identifier les agents utilisateurs de votre site permet d'accéder à **l'identité pivot**.

| Nom | Valeur |Caractère |Description |
| ------------------------- | -------------------------|-------------------------|--------------------------------------------|
Expand Down
40 changes: 15 additions & 25 deletions _data/guides/authentification.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,9 @@ publish: true # this page will appear on /guides page
api:
- API Pro Santé Connect
- FranceConnect et les API FranceConnectées
- AgentConnect
- ProConnect
- API Statut Etudiant
- API Statut étudiant boursier
- MonComptePro
---

## Dans quel cas l'authentification des personnes ou des organisations est nécessaire ?
Expand All @@ -27,43 +26,34 @@ Une fois implémenté par l'administration, il permet non seulement de garantir

[🔎 En savoir plus sur FranceConnect les API FranceConnectées](/les-api/franceconnect)

### 🏛️ Démarches administratives des entreprises et des associations
### 🏛️ Connecter des professionnels

Les entreprises et les associations doivent également s'authentifier auprès de l'administration, par exemple dans le cadre de demandes d'aides ou de subventions.
Certaines applications veulent pouvoir identifier des professionnels, que ce soit par exemple pour des démarches, du logiciel bureautique, des accès à des données.

Plutôt que de demander des justificatifs et de les vérifier manuellement, MonComptePro permet d'**obtenir l'identité de la structure** : Numéro SIRET, code Commune (COG), Code d'activité (NAF), etc... et de **vérifier automatiquement l'adresse e-mail** (correspondance du nom de domaine et vérification de la réception des e-mails).
Plutôt que de demander des justificatifs et de les vérifier manuellement, ProConnect permet d'**obtenir l'identité de la structure** : Numéro SIRET, code Commune (COG), Code d'activité (NAF), etc... et de **vérifier automatiquement l'adresse e-mail** (correspondance du nom de domaine et vérification de la réception des e-mails).

### 🔐 Accès à des données ou des logiciels
- [ProConnect](/les-api/agent-connect) pour les professionnels,
- [Pro Santé Connect](/les-api/api-pro-sante-connect) pour les professionnels de la sphère sanitaire et sociale

Certains logiciels et services en ligne sont réservés aux agents de l’État, d'autres sont accessibles uniquement aux professionnels de la santé. Lors de la création de compte pour accéder à ces applications, il est possible d'authentifier les utilisateurs de manière sécurisée :

- [AgentConnect](/les-api/agent-connect) pour les agents de l'État,
- [Pro Santé Connect](/les-api/api-pro-sante-connect) pour les professionnels de la sphère sanitaire et sociale,
- [MonComptePro](https://moncomptepro.beta.gouv.fr/partenaire) pour les agents l'État et l’ensemble des professionnels.

## Quelles API utiliser pour authentifier des personnes ou des organisations ?

| Population | FranceConnect | AgentConnect | MonComptePro | ProSantéConnect |
|----------------------------------------|---------------|--------------|--------------|-----------------|
| Particuliers |||||
| Professionnels |||||
| Professionnels de la santé |||||
| Entreprises |||||
| Agents de l'administration centrale |||||
| Agents des collectivités territoriales |||||

## Quid de ProConnect ?
| Population | FranceConnect | ProConnect | ProSantéConnect |
|----------------------------------------|---------------|--------------|-----------------|
| Particuliers ||||
| Professionnels ||||
| Professionnels de la santé ||||
| Entreprises ||||
| Agents de l'administration centrale ||||
| Agents des collectivités territoriales ||||

ProConnect ne permet pas d’authentifier les personnes. Il permet de certifier qu’une personne est bien un dirigeant. [Plus d’info](https://proconnect.gouv.fr/).

## Comment accéder aux API ?

Les API d’authentification sont réservées aux administrations et à leurs éditeurs.

#### [🇫🇷 API FranceConnect](/les-api/franceconnect)

#### [🏛️ API Agent Connect](/les-api/agent-connect)
#### [🏛️ API ProConnect](/les-api/agent-connect)

#### [🏥 API Pro Santé Connect](/les-api/api-pro-sante-connect)

#### [🏢 API MonComptePro](/les-api/moncomptepro)
11 changes: 5 additions & 6 deletions _data/guides/doctrine-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,12 +72,11 @@ L’accès aux API à accès restreint se fait par demande du réutilisateur (ad

Les API peuvent s’appuyer sur un mécanisme d’authentification de l’utilisateur final assurant une gestion des droits au sein de la plateforme qui les fournit. Les dispositifs d’authentification des citoyens, des agents ou des personnes morales conçus par les pouvoirs publics pourront être utilisés, en particulier lorsque le consentement de l’utilisateur est nécessaire pour faire circuler la donnée :

- Pour les personnes physiques : FranceConnect, AgentConnect, EduConnect et MonComptePro
- Pour les personnes morales : ProConnect
- Pour les personnes physiques : FranceConnect, ProConnect, EduConnect

#### Recommandation 4

Si le droit d’accès n’est pas préétabli, le processus de demande se fait de la manière la plus simple possible pour le réutilisateur.
Si le droit d’accès n’est pas préétabli, le processus de demande se fait de la manière la plus simple possible pour le réutilisateur.

Dans le cadre de demandes d’accès prévues par la loi et si le demandeur est éligible, une réponse sera transmise aux réutilisateurs **dans un délai recommandé de 15 jours calendaires.** Le code des relations entre le public et l’administration prévoit un délai légal maximum de 30 jours pour répondre à une demande [(article R311-13)](https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000031370409).

Expand Down Expand Up @@ -106,7 +105,7 @@ Pour les API ouvertes, le bac à sable potentiel est accessible au grand public,

Les données et services sont exposés selon des standards techniques communément partagés et adoptés.

En 2022, le principe d’architecture et d’encodage le plus connu et pratiqué est le **standard REST Json** pour les API synchrones.
En 2022, le principe d’architecture et d’encodage le plus connu et pratiqué est le **standard REST Json** pour les API synchrones.
Il est utilisé par exemple pour les spécifications du standard OpenAPI (https://spec.openapis.org/oas/v3.1.0) ou les standards "API" de l'OGC (https://ogcapi.ogc.org). Concernant les API asynchrones, le principe AsyncAPI est le plus répandu.

> ***👍 Bonne pratique :*** *L’approche « contract first », par opposition à l’approche « code first », est recommandée dans le développement de nouvelles interfaces car elle permet de les stabiliser et de faire travailler plusieurs équipes en parallèle au sein d’une même architecture.*
Expand All @@ -121,7 +120,7 @@ Les développements Agile ou nécessitant une évolution prévisible seront rend

#### Recommandation 8

**Ces périodes de validité de l’interface sont explicitement présentées aux réutilisateurs dans la documentation.** Les modifications prévisibles s’accompagneront de l’actualisation préalable des informations descriptives intégrant des liens vers des communications et guides permettant aux réutilisateurs d’anticiper les évolutions.
**Ces périodes de validité de l’interface sont explicitement présentées aux réutilisateurs dans la documentation.** Les modifications prévisibles s’accompagneront de l’actualisation préalable des informations descriptives intégrant des liens vers des communications et guides permettant aux réutilisateurs d’anticiper les évolutions.

Les réutilisateurs pourront basculer durant une période définie et communiquée sur la version modifiée de l’interface. Durant ce laps de temps, deux interfaces cohabiteront, la version précédente dépréciée et la nouvelle version.

Expand Down Expand Up @@ -199,6 +198,6 @@ Les données ainsi que les API sont mises à disposition gratuitement, pour les

> 💡 ***Exemple :*** *Dans le cas où des usages nécessiteraient une qualité de service au-dessus de ce que la multitude d’utilisateurs a couramment besoin, comme par exemple une bande passante élevée pour de la donnée temps-réel volumineuse desservie sur quelques organismes, il sera possible d’organiser un système freemium avec une égalité d’accès à des APIs par défaut et des APIs faisant l’objet de redevances pour les usages les plus exigeants.*
## Vous souhaitez distribuer une API ?
## Vous souhaitez distribuer une API ?

<Button href="/guides/diffusion-api-guide-pratique">Accéder au guide pratique</Button>
4 changes: 2 additions & 2 deletions components/questionTree/data/france-connected-api/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -41,13 +41,13 @@ const isQuestionsTree = {
choiceTree: [
{
choices: ['Fournisseur de services'],
answer: `Si vous souhaitez intégrer le bouton AgentConnect dans votre service, pouvez remplir cette demande :
answer: `Si vous souhaitez intégrer le bouton ProConnect dans votre service, pouvez remplir cette demande :
<Button href="https://datapass.api.gouv.fr/agent-connect-fs">Remplir une demande</Button>
`,
},
{
choices: ['Fournisseur d‘identité'],
answer: `Si vous souhaitez contribuer à AgentConnect en fournissant des données d'identité, vous pouvez remplir cette demande :
answer: `Si vous souhaitez contribuer à ProConnect en fournissant des données d'identité, vous pouvez remplir cette demande :
<br/>
<Button href="https://datapass.api.gouv.fr/agent-connect-fi">Remplir une demande</Button>
`,
Expand Down

0 comments on commit d370b40

Please sign in to comment.