Recherche


imprimer pdf
Comment gérer un nouvel utilisateur via les webservices OVH ?

Introduction


La gestion et la délegation des privilèges aux utilisateurs SMS peuvent se faire via les webservices suivants :


Api.ovh.com


Le nouveau webservice api.ovh.com n'utilise pas le mot de passe de l'utilisateur sms, contrairement à SoAPI. Il fait appel à une méthode d'authentification proche de OAuth.

Création des crendentials de l'utilisateur


Le principe consiste à affecter une partie des accès des urls de l'api à l'utilisateur sms, de récupérer cette autorisation via 3 tokens (Application Key, Application Secret, Consumer Key) et le communiquer au client.

Pour une affectation similaire des droits à celle de SoAPI, voici la liste des urls à autoriser :

  • DELETE /sms/{serviceName}/users/{login}/receivers/*
  • GET /sms/{serviceName}/users/{login}/receivers/*
  • POST /sms/{serviceName}/users/{login}/receivers
  • GET /sms/{serviceName}/users/{login}/receivers
  • DELETE /sms/{serviceName}/users/{login}/outgoing/*
  • GET /sms/{serviceName}/users/{login}/outgoing/*
  • GET /sms/{serviceName}/users/{login}/outgoing
  • DELETE /sms/{serviceName}/users/{login}/jobs/*
  • GET /sms/{serviceName}/users/{login}/jobs/*
  • POST /sms/{serviceName}/users/{login}/jobs
  • GET /sms/{serviceName}/users/{login}/jobs
  • DELETE /sms/{serviceName}/users/{login}/incoming/*
  • GET /sms/{serviceName}/users/{login}/incoming/*
  • GET /sms/{serviceName}/users/{login}/incoming
  • GET /sms/{serviceName}/users/{login}


"serviceName" => Le compte sms du client (Ex : sms-zzzz1-1)
"login" => Le login sms du client (Ex : "toto")

L'affectation des urls et la création du token peuvent se faire via :
https://api.ovh.com/createToken/





Exploitation des crendentials de l'utilisateur


Pour que l'utilisateur puisse profiter pleinement de ses privilèges, ce dernier doit utiliser ses 3 tokens (Application Key, Application Secret, Consumer Key) et les communiquer dans son URL de manière cryptée.

Ci-dessous, la documentation complète :
https://api.ovh.com/g934.first_step_with_api





Des wrappers pour faciliter les requêtes de l'API sont disponibles ici :

Perl : https://eu.api.ovh.com/wrappers/OvhApi-perl-1.1.zip
Python : https://eu.api.ovh.com/wrappers/OvhApi-python-1.0.zip
PHP : https://eu.api.ovh.com/wrappers/OvhApi-php-1.1.zip


Soapi (déprecié)


Sur SoAPI, c'est le mot de passe défini à la création du user qui est utilisé. L'utilisateur peut ainsi executer une fonction via celui-ci. Ci-dessous, un exemple avec la fonction d'envoi de sms depuis un user ovh.

http://www.ovh.com/soapi/fr/?method=telephonySmsUserSend



La méthode modification du mot de passe peut se faire via la méthode SoAPI : telephonySmsUserPassword
http://www.ovh.com/soapi/fr/?method=telephonySmsUserPassword