web-dev-qa-db-fra.com

Premiers pas avec Office 365 REST

Je suis sûr que des questions connexes ont été posées, mais je ne trouve pas cette réponse. J'essaie de créer un simple Ruby wrapper api pour Office 365, et je ne peux pas comprendre comment obtenir une oauth application créée (secret/token/callback url /.

Dans l'univers oauth/api de tout le monde, vous vous dirigez vers un portail de développeur et créez une `` application '' qui est livrée avec un jeton et un secret à utiliser avec votre bibliothèque générique oauth pour effectuer l'authentification basée sur un navigateur à 3 pattes . Je ne toucherai à aucun logiciel Windows/.net pour y parvenir - nous sommes en Ruby land.

Je pense que sur la base de la documentation dont j'ai besoin pour me diriger vers le portail de gestion Windows Azure pour créer quelque chose, mais je ne peux pas comprendre exactement ce que - et les choses que j'ai créées ne me donnent pas de jeton/secret/urls - ne devrait-il pas demander l'url/domaine de rappel?

Pour le oauth gem, je recherche ces types de détails;

def connection(credentials)
  OAuth2::Client.new(
      credentials[:client_id],
      credentials[:client_secret],
      :site => credentials[:base_url],
      :authorize_url => '/api/v1/oauth2/authorize',
      :token_url => '/api/v1/oauth2/token'
  )
end
oauthms-officeoffice365
30
Troy Anderson

[Mise à jour du 20 août 2015] : Il semble qu'il y ait une nouvelle expérience de démarrage à http://dev.office.com/getting-started/office365apis, qui vous aidera à enregistrer votre application et même à créer un projet de démarrage dans la langue de votre choix. Je recommanderais certainement d'essayer d'abord, plutôt que de suivre les étapes manuelles décrites ci-dessous.

Pour enregistrer des applications manuellement (par exemple, pas via Visual Studio et Outils d'API Office 365 ), vous devrez accéder au portail de gestion Azure à https://manage.windowsazure.com/ . En fonction de la référence SKU de votre locataire Office 365, vous pourrez peut-être vous connecter avec votre compte O365. Sinon, vous pouvez effectuer une étape manuelle pour associer un portail Azure (par exemple, un accès via un Live ID) à votre locataire O365. Faites-moi savoir si vous avez besoin de ces informations.

En supposant que vous puissiez accéder au portail actif, y trouver le nœud Active Directory et choisir le répertoire qui correspond à votre locataire O365.

De là, sélectionnez "Applications" et "Ajouter existant" pour enregistrer votre application: Select "Applications" and "Add Existing" to register your app:

Choisissez "Ajouter une application que mon organisation développe" Choose "Add an application my organization is developing"

Et remplissez les détails: Fill out the details (Step 1)Fill out the details (Step 2)

Une fois l'application créée, allez dans l'onglet configurer . Vous y trouverez l'ID client, vous pouvez générer le secret et (peut-être le plus important) définir des autorisations pour que votre application accède aux API Office 365.

Configure Tab with client ID, permissions, etc

J'espère que cela t'aides!

[~ # ~] mise à jour [~ # ~] :

Après avoir enregistré l'application, je vous encourage vivement à consulter les exemples trouvés ici: application Web et application native (dans ce cas, Windows 8.1) . Ceux-ci contiennent d'excellents exemples sur la façon de faire OAuth, et vous pouvez également voir quels points de terminaison sont utilisés pour accéder aux différents services (et un exemple de Service Discovery pour SharePoint, par exemple).

Dans les exemples, les informations de point de terminaison API et d'ID de ressource pour les services se trouvent dans le fichier "Office365ServiceInfo.cs" (sous le dossier "Models" dans l'application Web et le dossier "Office365" pour l'application native), et le code d'authentification peut être trouvé sous "Contrôleurs/Office365CommonController" pour l'application Web et "Office365/Office365Helper" pour l'application native. Je vous encourage également à lire la section "Exploration de la structure du projet" de cet article de blog .

MISE À JOUR 2 : la documentation MSDN qui décrit l'ajout et la configuration d'applications dans le portail Azure se trouve ici: http://msdn.Microsoft. com/fr-fr/library/dn132599.aspx

MISE À JOUR 3 : Une nouvelle documentation a été ajoutée à MSDN, qui couvre à la fois les étapes ci-dessus, et également comment accéder au portail Azure pour votre développeur O365 Site: http://msdn.Microsoft.com/en-us/library/office/dn736059 (v = office.15) .aspx

~ Michael

39
Michael Zlatkovsky - Microsoft