Authentification et sécurité - Historique des versions

Mschmit52a93 le 22 février 2021 à 15:52

2021-02-22T15:52:30Z

Woussen.alexis59c630e le 27 janvier 2021 à 09:48

2021-01-27T09:48:59Z

Garmand2db17 le 22 décembre 2020 à 15:52

2020-12-22T15:52:00Z

Ikbot le 8 février 2017 à 15:00

2017-02-08T15:00:07Z

Mschmit52a93 le 19 octobre 2016 à 09:39

2016-10-19T09:39:18Z

Mschmit52a93 le 19 octobre 2016 à 09:38

2016-10-19T09:38:35Z

Rbelouizdad5dc3a le 2 mai 2016 à 09:48

2016-05-02T09:48:35Z

Jquiaios31670 le 3 décembre 2015 à 17:05

2015-12-03T17:05:38Z

Ikbot le 24 novembre 2015 à 13:03

2015-11-24T13:03:15Z

Ikbot : Robot : Remplacement de texte automatisé (-sécurité +{{Template:Sécurité}})

2015-11-04T15:58:14Z

Robot : Remplacement de texte automatisé (-sécurité +{{Template:Sécurité}})

← Version précédente		Version du 22 février 2021 à 15:52
Ligne 24 :		Ligne 24 :
	}}		}}

−	~~==Introduction==~~	+	#REDIRECT [[Comment_utiliser_l'API_d’Ikoula]]
−	~~Comment s'authentifier à l'API Ikoula et les politiques de {{Template:Sécurité}} ?~~
−
−	~~==Explications==~~
−	~~Pour des raisons évidentes de {{Template:Sécurité}}, l'API Ikoula exige une authentification. Celle-ci est basée sur un identifiant, un mot de passe et une signature :<br />~~
−	* L'identifiant est l'adresse e-mail utilisée pour la connexion à votre compte Ikoula ou à l'extranet. Le nom du paramètre pour le transmettre est toujours <span class="notranslate">'''login'''</span> ;
−	* Le mot de passe quant à lui peut être, soit fourni en texte clair (paramètre <span class="notranslate">'''password'''</span>), soit chiffré via une fonction spécifique utilisant une clé publique fournie par Ikoula (paramètre <span class="notranslate">'''crypted_password'''</span>) et base64_encode ;
−	* La signature est générée en fonction des paramètres fournis lors de l'appel à l'API (voir la procédure de génération de la signature ==> [[~~Génération_de_la_signature\|Génération de la signature]]).~~
−	~~<br />~~
−	'~~''Ces paramètres doivent toujours être passés en GET à l'API !'''~~
−	~~<br /><br />ATTENTION :<br />~~
−	Le passage du mot de passe en texte clair est fourni pour faciliter la prise en main de l'API et fait office de debug. Pour vos tests de l'API, vous pouvez, par exemple, utiliser un utilisateur temporaire dédié à ces tests et vous authentifier avec son mot de passe en clair (voir le Wiki ci-après pour la création de sous-utilisateur: https://support.ikoula.com/index-1-2-2835.html).<br /><br />
−	~~L'utilisation du chiffrement de mot de passe avec la clé publique Ikoula est indispensable dans tout contexte de production ou non-court terme.<br />~~
−	Si les appels API sont voués à être utilisés via un script ou un programme, nous vous recommandons la création d'un utilisateur dédié à cet effet plutôt que d'utiliser votre utilisateur extranet classique.<br />
−	~~Deux possibilités s'offrent à vous :<br />~~
−	* Contacter notre support pour la création d'un utilisateur extranet ;
−	* Créer un sous-utilisateur directement depuis la page d'accueil de votre compte extranet (Voir le WIKI ci-après pour la création de sous-utilisateur: https://support.ikoula.com/index-1-2-2835.html).
−	~~Attention à ne pas oublier '''de lui mettre les droits sur les prestations souhaitées'''.~~
−	~~<br /><br />~~
−	~~;La clé publique de chiffrement du mot de passe est disponible à l'adresse suivante:~~
−	~~: https://api.ikoula.com/downloads/Ikoula.API.RSAKeyPub.pem~~
−
−	~~==Exemples==~~
−	~~Pour cet exemple, le login sera "ikoulasupport".<br />~~
−	~~Pour crypter le mot de passe, voici un exemple de fonction utilisant la clé publique {{Template:IKoula}} :<br /><br />~~
−	~~<syntaxhighlight lang="php">~~
−	~~// Chemin local vers la clef publique téléchargée à http://api.ikoula.com/downloads/Ikoula.API.RSAKeyPub.pem~~
−	~~define('API_PUB_KEY_PATH', dirname(__FILE__) . '/Ikoula.API.RSAKeyPub.pem');~~
−
−	~~// Fonction de cryptage du mot de passe via la clef publique Ikoula~~
−	~~function opensslEncryptPublic($password)~~
−	{
−	~~// Vérification de la présence de la clef publique~~
−	~~if(file_exists(API_PUB_KEY_PATH))~~
−	{
−	~~if(!empty($password))~~
−	{
−	~~// on récupére la clef public~~
−	~~$publicKey = openssl_pkey_get_public('file://'.realpath(API_PUB_KEY_PATH));~~
−
−	~~// Si il n'y a pas eu d'erreur lors de la récupération de la clef publique on continue~~
−	~~if ($publicKey !== FALSE)~~
−	{
−	~~// Si chiffrement clef publique OK~~
−	~~if(openssl_public_encrypt($password, $crypted, $publicKey) === TRUE)~~
−	{
−	~~// Renvoie du passe crypté~~
−	~~return $crypted;~~
−	}
−	~~else~~
−	{
−	~~return NULL;~~
−	}
−	}
−	~~else~~
−	~~return NULL;~~
−	}
−	~~else~~
−	~~return NULL;~~
−	}
−	~~else~~
−	{
−	~~echo("Erreur la clée public n'est pas présente.\n");~~
−	~~return NULL;~~
−	}
−	}
−
−	~~// Utilisation de la fonction de cryptage~~
−	~~$password_crypt = opensslEncryptPublic("Mot de passe non crypté");~~
−	~~if($password_crypt != NULL)~~
−	~~echo "OK Mot de passe crypté: ".$password_crypt;~~
−	~~else~~
−	~~echo "Erreur lors du cryptage du mot de passe.";~~
−
−	~~// ==> $password_crypt contient donc le mot de passe crypté~~
−	~~</syntaxhighlight>~~
−
−	~~==Conclusion==~~
−	~~Une fois le mot de passe crypté et la signature cryptée, on peut donc faire l'appel API avec comme paramètres (si on suit l'exemple ci-dessus) :<br />~~
−	* login = ikoulasupport ;
−	* crypted_password = base64_encode($password_crypt) ;
−	* signature = signature générée (voir la procédure de génération de la signature ==> [[Génération_de_la_signature\|Génération de la signature]]).
−	~~<br />~~
−	~~'''NB : N'oubliez pas d'url_encoder chaque paramètre passé !'''~~
−
−	~~<!-- Fin de l'article -->~~
−	~~<br /><br />~~
−	~~Cet article vous a semblé utile ? <vote />~~
−	~~<!-- Placez ici la catégorie à laquelle se rapporte votre article. Ex: [[Categorie:Contribuer]] -->~~
−	~~[[Catégorie:API]]~~
−	~~[[Catégorie:Serveur_dédié~~]]
−
−	~~<!-- Gestion SEO. Indiquez les informations manquantes -->~~
−	~~<br />~~
−	~~<comments />~~

@@ Ligne 15 : / Ligne 15 : @@
 <!-- Début de l'article. Placez votre texte ci-après et n'hésitez pas à personnaliser les chapitres selon votre besoin -->
+{{#seo:
 ==Introduction==

@@ Ligne 107 : / Ligne 107 : @@
 <!-- Placez ici la catégorie à laquelle se rapporte votre article. Ex: [[Categorie:Contribuer]] -->
 [[Catégorie:API]]
 <!-- Gestion SEO. Indiquez les informations manquantes -->
 <br />
 <comments />

← Version précédente		Version du 8 février 2017 à 15:00
Ligne 1 :		Ligne 1 :
		+	<span data-link_translate_fr_title="Authentification et sécurité" data-link_translate_fr_url="Authentification et sécurité"></span>[[:fr:Authentification et sécurité]][[fr:Authentification et sécurité]]
	<span data-link_translate_he_title="אבטחה ואימות" data-link_translate_he_url="%D7%90%D7%91%D7%98%D7%97%D7%94+%D7%95%D7%90%D7%99%D7%9E%D7%95%D7%AA"></span>[[:he:אבטחה ואימות]][[he:אבטחה ואימות]]		<span data-link_translate_he_title="אבטחה ואימות" data-link_translate_he_url="%D7%90%D7%91%D7%98%D7%97%D7%94+%D7%95%D7%90%D7%99%D7%9E%D7%95%D7%AA"></span>[[:he:אבטחה ואימות]][[he:אבטחה ואימות]]
	<span data-link_translate_ro_title="Autentificare și securitate" data-link_translate_ro_url="Autentificare+%C8%99i+securitate"></span>[[:ro:Autentificare și securitate]][[ro:Autentificare și securitate]]		<span data-link_translate_ro_title="Autentificare și securitate" data-link_translate_ro_url="Autentificare+%C8%99i+securitate"></span>[[:ro:Autentificare și securitate]][[ro:Autentificare și securitate]]

@@ Ligne 16 : / Ligne 16 : @@
-==Introduction== <!--T:1-->
+==Introduction==
 Comment s'authentifier à l'API Ikoula et les politiques de {{Template:Sécurité}} ?
-==Explications== <!--T:2-->
+==Explications==
 Pour des raisons évidentes de {{Template:Sécurité}}, l'API Ikoula exige une authentification. Celle-ci est basée sur un identifiant, un mot de passe et une signature :<br />
 * L'identifiant est l'adresse e-mail utilisée pour la connexion à votre compte Ikoula ou à l'extranet. Le nom du paramètre pour le transmettre est toujours  <span class="notranslate">'''login'''</span> ;
@@ Ligne 38 : / Ligne 38 : @@
 : https://api.ikoula.com/downloads/Ikoula.API.RSAKeyPub.pem
-==Exemples== <!--T:3-->
+==Exemples==
 Pour cet exemple, le login sera "ikoulasupport".<br />
 Pour crypter le mot de passe, voici un exemple de fonction utilisant la clé publique {{Template:IKoula}} :<br /><br />
@@ Ligne 93 : / Ligne 93 : @@
 </syntaxhighlight>
-==Conclusion== <!--T:5-->
+==Conclusion==
 Une fois le mot de passe crypté et la signature cryptée, on peut donc faire l'appel API avec comme paramètres (si on suit l'exemple ci-dessus) :<br />
 * login = ikoulasupport ;
@@ Ligne 101 : / Ligne 101 : @@
 '''NB : N'oubliez pas d'url_encoder chaque paramètre passé !'''
 <!-- Fin de l'article -->
 <br /><br />
@@ Ligne 108 : / Ligne 107 : @@
 [[Catégorie:API]]
 <!-- Gestion SEO. Indiquez les informations manquantes -->
 <br />
 <comments />

@@ Ligne 90 : / Ligne 90 : @@
          echo "Erreur lors du cryptage du mot de passe.";
 // ==> $password_crypt contient donc le mot de passe crypté
 </syntaxhighlight>

@@ Ligne 21 : / Ligne 21 : @@
 ==Explications== <!--T:2-->
 Pour des raisons évidentes de {{Template:Sécurité}}, l'API Ikoula exige une authentification. Celle-ci est basée sur un identifiant, un mot de passe et une signature :<br />
-* L'identifiant est l'adresse mail utilisée pour la connexion à votre compte Ikoula ou à l'extranet. Le nom du paramètre pour le transmettre est toujours  <span class="notranslate">'''login'''</span>.
+* L'identifiant est l'adresse e-mail utilisée pour la connexion à votre compte Ikoula ou à l'extranet. Le nom du paramètre pour le transmettre est toujours  <span class="notranslate">'''login'''</span> ;
-* Le mot de passe quant à lui peut être, soit fourni en texte clair (paramètre  <span class="notranslate">'''password'''</span>), soit chiffré via une fonction spécifique utilisant une clé publique fournie par Ikoula (paramètre  <span class="notranslate">'''crypted_password'''</span>) et base64_encode
+* Le mot de passe quant à lui peut être, soit fourni en texte clair (paramètre  <span class="notranslate">'''password'''</span>), soit chiffré via une fonction spécifique utilisant une clé publique fournie par Ikoula (paramètre  <span class="notranslate">'''crypted_password'''</span>) et base64_encode ;
-* La signature est générée en fonction des paramètres fournis lors de l'appel à l'API (voir la procédure de génération de la signature ==> [[Génération_de_la_signature|Génération de la signature]])
+* La signature est générée en fonction des paramètres fournis lors de l'appel à l'API (voir la procédure de génération de la signature ==> [[Génération_de_la_signature|Génération de la signature]]).
 <br />
 '''Ces paramètres doivent toujours être passés en GET à l'API !'''
-<br /><br />ATTENTION:<br />
+<br /><br />ATTENTION :<br />
-Le passage du mot de passe en texte clair est fourni pour faciliter la prise en main de l'API et fait office de debug. Pour vos tests de l'API, vous pouvez par exemple utiliser un utilisateur temporaire dédié à ces tests et vous authentifier avec son mot de passe en clair (Voir le WIKI ci-après pour la création de sous-utilisateur: https://support.ikoula.com/index-1-2-2835.html).<br /><br />
+Le passage du mot de passe en texte clair est fourni pour faciliter la prise en main de l'API et fait office de debug. Pour vos tests de l'API, vous pouvez, par exemple, utiliser un utilisateur temporaire dédié à ces tests et vous authentifier avec son mot de passe en clair (voir le Wiki ci-après pour la création de sous-utilisateur: https://support.ikoula.com/index-1-2-2835.html).<br /><br />
 L'utilisation du chiffrement de mot de passe avec la clé publique Ikoula est indispensable dans tout contexte de production ou non-court terme.<br />
 Si les appels API sont voués à être utilisés via un script ou un programme, nous vous recommandons la création d'un utilisateur dédié à cet effet plutôt que d'utiliser votre utilisateur extranet classique.<br />
 Deux possibilités s'offrent à vous :<br />
-* Contacter notre support pour la création d'un utilisateur extranet
+* Contacter notre support pour la création d'un utilisateur extranet ;
 * Créer un sous-utilisateur directement depuis la page d'accueil de votre compte extranet (Voir le WIKI ci-après pour la création de sous-utilisateur: https://support.ikoula.com/index-1-2-2835.html).
 Attention à ne pas oublier '''de lui mettre les droits sur les prestations souhaitées'''.
@@ Ligne 96 : / Ligne 96 : @@
 ==Conclusion== <!--T:5-->
 Une fois le mot de passe crypté et la signature cryptée, on peut donc faire l'appel API avec comme paramètres (si on suit l'exemple ci-dessus) :<br />
-* login = ikoulasupport
+* login = ikoulasupport ;
-* crypted_password = base64_encode($password_crypt)
+* crypted_password = base64_encode($password_crypt) ;
-* signature = signature générée (voir la procédure de génération de la signature ==> [[Génération_de_la_signature|Génération de la signature]])
+* signature = signature générée (voir la procédure de génération de la signature ==> [[Génération_de_la_signature|Génération de la signature]]).
 <br />
 '''NB : N'oubliez pas d'url_encoder chaque paramètre passé !'''

← Version précédente		Version du 24 novembre 2015 à 13:03
Ligne 1 :		Ligne 1 :
		+	<span data-link_translate_he_title="אבטחה ואימות" data-link_translate_he_url="%D7%90%D7%91%D7%98%D7%97%D7%94+%D7%95%D7%90%D7%99%D7%9E%D7%95%D7%AA"></span>[[:he:אבטחה ואימות]][[he:אבטחה ואימות]]
	<span data-link_translate_ro_title="Autentificare și securitate" data-link_translate_ro_url="Autentificare+%C8%99i+securitate"></span>[[:ro:Autentificare și securitate]][[ro:Autentificare și securitate]]		<span data-link_translate_ro_title="Autentificare și securitate" data-link_translate_ro_url="Autentificare+%C8%99i+securitate"></span>[[:ro:Autentificare și securitate]][[ro:Autentificare și securitate]]
	<span data-link_translate_ru_title="Проверка подлинности и безопасность" data-link_translate_ru_url="%D0%9F%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BA%D0%B0+%D0%BF%D0%BE%D0%B4%D0%BB%D0%B8%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8+%D0%B8+%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C"></span>[[:ru:Проверка подлинности и безопасность]][[ru:Проверка подлинности и безопасность]]		<span data-link_translate_ru_title="Проверка подлинности и безопасность" data-link_translate_ru_url="%D0%9F%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BA%D0%B0+%D0%BF%D0%BE%D0%B4%D0%BB%D0%B8%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8+%D0%B8+%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C"></span>[[:ru:Проверка подлинности и безопасность]][[ru:Проверка подлинности и безопасность]]