How to use the Cloud Ikoula private API

This article has been created by an automatic translation software. You can view the article source here.

When you register for the service b. Cloud Private Ikoula, you received an email with an API key and a secret key. This information will allow you to connect to the API b. Cloud Private Ikoula.

URL API : https://cloudstack.ikoula.com/client/api

The domain administrator and user API specifications are respectively :

Admin : http://cloudstack.apache.org/docs/api/apidocs-4.2/TOC_Domain_Admin.html User : http://cloudstack.apache.org/docs/api/apidocs-4.2/TOC_User.html

The use of the API, to :

• Your API key
• Your secret key
• Send queries on "https://cloudstack.ikoula.com/client/api" with a method of HTTP
• Treat the return XML or JSON (choice )

Example of a query has the API using the GET method :

1. https://cloudstack.ikoula.com/client/api/
2. ?command =deployVirtualMachine
3. &serviceOfferingId =1
4. &diskOfferingId =1
5. &templateId =2
6. &zoneId =4
7. &apiKey =miVr 6X7u6bN_EJTVwZ 0nUkkJbPmY 3y2bciKwFQ
8. &signature =LXX 1DM 40AjcXU %2FcaiK 8RAP 0O1hU %3D

The line 1 corresponds to the point of entry (the link to the API b. Cloud Ikoula private ) The line 2 correspond a la command e a envoyer, ici on veut crée une nouvelle VM The line 3-6 correspondent aux différents paramètres de la command e. You can add the fields "response" which defined the return with the parameter format (XML /JSON ) The line 7 contains your API key (Here is an invalid example key, replace with your ) The line 8 est la signature générée à partir de la command e et de votre clé secrète

How to generate signature ?

We must ensure that all spaces are replaced by "%20" instead of "+"

To sort alphabetically sent fields. Attention to the settings one after the other separated by a & (Ampersand )and the string to lowercase.

Example of string parameters : apikey =mivr 6x7u6bn_ejtvwz 0nukkjbpmy 3y2bcikwfq &command =listvirtualmachines &Networkid =5

Finally apply a hmac_SHA 1 sur la chaîne générée avec comme clé de hashage votre clé secréte. Pour envoyer la requête il vous suffit de rajouter le champs signature avec la signature générée

$args is an associative array of all the arguments

// classement par clef
ksort($args);
$query = http_build_query($args);
// sécurité pour l'encodage des espaces
$query = str_replace("+", "%20", $query);
// minuscule
strtolower($query)
// calcul du hash
$hash = hash_hmac("SHA1",  $query, $secretKey, true);
// encodage en base 64
$signature = base64_encode($hash);
?>

Sort by date Sort by score

Enable comment auto-refresher

You are not allowed to post comments.