/microsoft-graph-explorer-v4

React/Redux version of Graph Explorer used to learn the Microsoft Graph Api

Primary LanguageTypeScriptMIT LicenseMIT

Microsoft Graph Explorer V4

Build Status

The Microsoft Graph Explorer V4 lets developers quickly navigate and test API endpoints.

The Graph Explorer is written in TypeScript and powered by:

Running the explorer locally

Microsoft Graph Explorer is built and developed using node v18.

  • npm install to install project dependencies. npm is installed by default with Node.js.
  • npm start starts the TypeScript compiler in watch mode and the local server. It should open your browser automatically with the Graph Explorer at http://localhost:3000/.

Enabling authentication with your own credentials

  • Sign in to your Microsoft account (or Create one) at the Microsoft Azure Portal.
  • Find the Azure service named App registrations. If you haven't used this service before, you might need to search for it in the search bar.
  • In the App registrations page, click + New registration. You will be redirected to a form in the Microsoft Azure portal where you Register an application. Fill out the form and set the Redirect URI to a Single-page application (SPA) with http://localhost:3000. You can also set it from authentication tab in the app you have just created.
  • Create a .env file at the root of the project/repo and add the following keys. - REACT_APP_CLIENT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx - REACT_APP_INSTRUMENTATION_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx Where REACT_APP_CLIENT_ID is the Application (client) ID from the Azure portal and REACT_APP_INSTRUMENTATION_KEY is the Object ID from the portal.

Other commands

  • npm test to run tests from the command line for scenarios like parsing metadata and functional explorer tests.
  • npm run lint linting your files

Getting Help & Guides

Where To Get Support

Are you having any trouble with Micrososft Graph or would you like to request a Graph feature?

Are you new to Graph Explorer or would like to raise a bug or request a feature?

Building Apps & Accessing M365 Data

  • To simplify your Microsoft Graph app-building experience, use our Microsoft Graph SDKs and Microsoft Graph Toolkit (MGT) which provide fully functional and out-of-the-box web components.

  • Refer to Microsoft Graph Quick Start to get a pre-initialized SDK sample application up and running in less 3 minutes using the language of your choice.

Contributing

Please see the contributing guidelines.

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.

E2E playwright testing

  • Playwright requires a running GE Url to run against.
  • In your .env file, create add variables:
    • PLAYWRIGHT_TESTS_USERNAME='your demo tenant email address'
    • PLAYWRIGHT_TESTS_PASSWORD='password to the demo tenant account'
    • PLAYWRIGHT_TESTS_BASE_URL='url that you are running against' // http://localhost:3000 if testing locally
  • Save your changes.
  • On your terminal run the command npx playwright install
  • On your terminal run the command npx playwright install-deps.
  • Once the installation is complete run the command npx playwright test ui.
  • Playwright commands can be extended using arguments described in the official documentation Running tests

Additional resources

Copyright

Copyright (c) 2017 Microsoft. All rights reserved.