How do I start Microsoft OAuth?

How do I start Microsoft OAuth?

Microsoft OAuth has multiple steps. We're breaking this down into bite-sized pieces and providing a walkthrough video to help save your sanity. 

Before you begin make sure you have: 
  1. Your Proxy URL.
  2. Your Microsoft login.
  3. Your CloudSponge login. 
  4. Your logo.
  5. Links to your site, privacy policy, and terms of service.
  1. Sign in to Azure Portal and click on App Registrations in the Azure Portal. 
  2. Click on New Registration and complete the “Register an application” form.
    1. Name: Enter the name of your app.
    2. Supported account types: choose “Accounts in any organizational directory and personal Microsoft accounts.” This is an important step. Without the correct selection, you will be limited by who is able to share their contacts based on the type of Microsoft account they have.
    3. Redirect URI: select the “Web” platform and enter the public URL of your Proxy URL.
    4. Click Register to create the registration. You should be redirected to the new App registration. If not, go to App Registrations on the left-hand side. 
  3. Click on Manage > Branding & Properties in the App Registrations side menu. This page lets you specify what the user will see and input your branding details:
    1. Upload your logo, paying close attention to Microsoft’s requirements for image format and size. This is considered best practice since it creates a visual cue for users as they are being asked to share their information.
    2. Enter the URLs for your Home page, Terms of Service, and Privacy Statement. These pages are linked to from the OAuth consent page.
  4. Add API permissions:
    1. Click on Manage > API permissions in the App registrations side menu. 
    2. Click on Add a permission to open the permissions selector.
    3. Click on Microsoft Graph
    4. Click on Delegated permissions
    5. Find and select Contacts.Read in the list.
    6. Click Add Permissions.

  5. Get your Client Secret:
    1. Click on Manage > Certificates & Secrets in the App registrations side menu. 
    2. Click on New client secret.
    3. Enter a Description for the secret, e.g., CloudSponge.
    4. Select “24 months” for the Expires date.
    5. Record your “Value,” and save it somewhere safe. You will not be able to retrieve it later on and will be forced to create a new client secret. You need your Client Secret Value to add to your CloudSponge account.'
    6. Click Add.
    7. Take a big sigh of relief and grab a cup of coffee for the next steps. 

We're waiting for your questions at support@cloudsponge.com. Reach out, we're lonely. 

    • Related Articles

    • How to add your Microsoft OAuth credential to your CloudSponge account

      Did you complete the first steps to get your Microsoft OAuth? Yes?!? Sweet. Here are the simple steps to add your Microsoft OAuth credentials to your CloudSponge account: 1. Sign in to your CloudSponge account and Add your OAuth Credential from your ...

    • What account should I use to sign-in for Microsoft OAuth in the Azure portal?

      We've learned that Microsoft is as finicky about what the login you use for your OAuth project as our children are with vegetables. It's best to use one of the following: A Office365 hosted login. A non-Office365 hosted login. A personal @outlook.com ...

    • How do I verify my domain for Microsoft OAuth?

      It's time to verify your domain for Microsoft. If you don't, you'll be sorry. Just kidding. However, this is a must to show your users that your site is trustworthy. You need to verify your domain in order to show the blue verified check mark your ...

    • What do I do if my shared Google credentials aren’t working anymore?

      Years ago, CloudSponge was able to share Google OAuth credentials. Over time, Google stopped allowing us to share these credentials with you. You will need to get verified by Google for the People API. You can read our complete guide on Google OAuth ...

    • How do I make a successful demo video for Google OAuth?

      We recommend you start by watching this video: Our CTO wizard, Graeme has also written an extensive blog about demo videos for Google OAuth. If you need help, don't be afraid to put us to the test at support@cloudsponge.com. Just don't ask us to fix ...