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.