Environnements
Cette page donne des informations générales sur les certificats dans nos services, ainsi que sur les environnements de production et de test. Notez que vous devez utiliser des certificats différents pour ces deux environnements. Le certificat de test se télécharge sur la page Informations de test ; celui de production se commande auprès d’ExcelID.
À propos des certificats
Nos services reposent sur des certificats : il vous en faut un valide pour les utiliser. Les certificats servent à identifier votre organisation et à indiquer, à l’utilisateur, auprès de quel service il s’identifie ou signe une information. Le nom porté par votre certificat (displayName) est celui qu’il voit dans l’application ExcelID.
Votre certificat doit être installé dans votre « magasin de clés » (key store). Il n’a pas à être vérifié par votre application, et l’émetteur du certificat n’est pas nécessaire : notre serveur présente son propre certificat, et la vérification du vôtre se fait pendant la poignée de main TLS à l’ouverture du canal.
En revanche, votre application doit vérifier le certificat de notre serveur. Pour cela, l’émetteur du certificat du serveur doit être installé dans votre « magasin de confiance » (trust store).
Bon à savoir : le test et la production utilisent des certificats différents ; un certificat peut devoir être converti dans un autre format pour votre environnement ; votre application doit pouvoir accéder à son magasin de clés et à son magasin de confiance, et utiliser les bons.
Environnement de production
| Service | Adresse |
|---|---|
| Identification et signature | Communiquée avec votre certificat de production |
| Vérification de la carte numérique | Communiquée avec votre certificat de production |
Certificat de production
Le certificat de production vous est délivré par ExcelID après accord. Utilisez l’émetteur du certificat comme racine de confiance : si vous faisiez confiance au certificat lui-même, votre service ne pourrait plus accéder à notre serveur le jour où il est renouvelé.
Environnement de test
Nous proposons un environnement de test pour développer et tester votre service. Pour l’utiliser, vous devez :
- avoir un certificat pour l’environnement de test ;
- utiliser l’adresse du service de test ;
- faire confiance à l’émetteur du certificat de test ;
- avoir une application ExcelID configurée pour le test ;
- avoir un ExcelID de test.
| Service | Adresse de test |
|---|---|
| Identification et signature | https://www.excelidapi.aikinggroup.com/v1/ |
| Vérification de la carte numérique | https://www.excelidapi.aikinggroup.com/v1/idcard/ |
L’environnement de test fonctionne comme la production. Une clé d’API envoyée dans l’en-tête X-Api-Key peut remplacer le certificat pour les premiers essais.
Pour l’ExcelID de test et sa configuration, voir Configurer ExcelID de test.
Ce qui change entre les deux environnements
- Une demande expire 180 secondes après sa création.
- Dans l’environnement de test, une demande adressée à une personne qui n’a pas d’ExcelID échoue tout de suite (
startFailed), pour ne pas faire attendre. En production, l’existence d’un utilisateur n’est jamais révélée. - Il n’existe pas d’ExcelID de test en production : un ExcelID réel ne peut être détenu que par une personne réelle, activée par un partenaire après vérification de sa pièce d’identité.