Preberi v angleščini

Deli z drugimi prek

Microsoft Graph sample Ruby on Rails app

  • Code Sample
Browse code

Ruby License.

This sample demonstrates how to use the Microsoft Graph REST API to access data in Office 365 from Ruby on Rails apps.

NOTE: This sample was originally built from a tutorial published on the Microsoft Graph tutorials page. That tutorial has been removed.

Prerequisites

To run the completed project in this folder, you need the following:

This sample was written for Ruby 3.1.2.

Register a web application with the Microsoft Entra admin center

  1. Open a browser and navigate to the Microsoft Entra admin center. Login using a Work or School Account.

  2. Expand Identity in the left-hand navigation, expand Applications, then select App registrations.

  3. Select New registration. On the Register an application page, set the values as follows.

    • Set Name to Ruby Graph Tutorial.
    • Set Supported account types to Accounts in any organizational directory and personal Microsoft accounts.
    • Under Redirect URI, set the first drop-down to Web and set the value to http://localhost:3000/auth/microsoft_graph_auth/callback.

  4. Choose Register. On the Ruby Graph Tutorial page, copy the value of the Application (client) ID and save it, you will need it in the next step.

  5. Select Certificates & secrets under Manage. Select the New client secret button. Enter a value in Description and select one of the options for Expires and choose Add.

  6. Copy the client secret value before you leave this page. You will need it in the next step.

Configure the sample

  1. Rename the ./graph-sample/config/oauth_environment_variables.rb.example file to oauth_environment_variables.rb.

  2. Edit the oauth_environment_variables.rb file and make the following changes.

    1. Replace YOUR_APP_ID_HERE with the Application Id you got from the App Registration Portal.
    2. Replace YOUR_APP_SECRET_HERE with the secret you got from the App Registration Portal.

  3. In your command-line interface (CLI), navigate to the ./graph-sample directory and run the following command to install requirements.

    Shell 
    bundle install

  4. In your CLI, run the following command to initialize the app's database.

    Shell 
    rake db:migrate

Run the sample

  1. Run the following command in your CLI to start the application.

    Shell 
    rails server

  2. Open a browser and browse to http://localhost:3000.

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.