Skip to main content

Social platform configuration

Apple

  1. Create an Apple Developer account, see Apple Developer Program: What You Need To Enroll in the Apple documentation.

  2. Register an App ID in Apple Developer, see Register an App ID in the Apple documentation.

  3. Configure sign in with Apple in Apple Developer, see Configure Sign in with Apple for the web in the Apple Developer documentation.

    1. Note down the Services ID you created.
    2. Paste https://your_domain_goes_here/oidc/apple/ as the Website URL in Apple Developer.
  4. Go to NevisAdmin4 Infrastructure → Inventory editor & paste Services ID: apple-client-id: Services ID

    You can find the Services ID in Apple Developer. Go to Certificates, Identifiers & Profiles > Identifiers and select Services IDs in the drop-down on the top right.

  5. Create and download a private key file in Apple Developer, see Create a private key to access a service in the Apple Developer documentation.

    1. Select Sign in with Apple and Configure your registered App ID as Primary App ID.
    2. Download your private key.
caution

You can download your private key only once. Save a backup of your private key in a secure place!

  1. Go to NevisAdmin4 Configurations → Patterns → apple (Apple Login Step type) → Secret tab & upload the file you downloaded above.
  2. Set the pattern’s Issuer → Team ID (in your Apple Developer account under Membership details).
  3. Save your nevisAdmin4 changes and deploy your project!!!

Facebook

  1. Create a Facebook for Developers account, see Register as a Facebook Developer in the Facebook for Developers documentation.

  2. Create an App, and select Business or Consume as app type, see Create an App in the Facebook for Developers documentation. Add the Facebook login product to the App. Set the App to be in Live mode in case of Consumer app type.

  3. To have Advanced Permission to email and public_profile, see Facebook Login Overview in the Facebook for Developers documentation.

  4. Paste: https://your_domain_goes_here/oauth2/facebook/

    App->Products under Facebook Login > Configure/Settings as Valid OAuth Redirect URIs in Facebook for Developers.

  5. In Facebook for Developers, go to your App Settings > Basic, where you can find the App ID and App secret.

  6. Copy the App ID & app secret.

  7. Go to NevisAdmin4 Infrastructure → Inventory editor & paste both values.

    • facebook-client-id: App ID
    • facebook-client-secret: app secret
  8. Save your nevisAdmin4 changes and deploy your project!!!

Google

  1. Create a Google Developers account, see Google Identity Overview in the Google Developers documentation.
  2. Create a Project, see Creating and managing projects in the Google Developers documentation.
  3. Create an OAuth client ID credential.
  4. Open the created credential.
  5. Paste https://your_domain_goes_here/oidc/google/ as Authorized redirect URIs, see OpenID Connect in the Google Developers documentation.
  6. Copy Client ID and Client secret.
  7. Go to NevisAdmin4 Infrastructure → Inventory editor & paste both values.
    • google-client-id: Client ID
    • google-client-secret: Client secret
  8. Save your nevisAdmin4 changes and deploy your project!!!

Microsoft

  1. Create a Microsoft account, see How to create a new Microsoft account for details.
  2. Using your Microsoft account, log into Azure portal.
  3. Register your application with Azure, see Configure your App Service or Azure Functions app to use Microsoft Account login for details.
    1. Choose a multitenant account type that supports all your users, corporate or personal, or both. For more information click Help me choose...
    2. Select Web in Platform type.
    3. Paste https://your_domain_goes_here/oidc/microsoft/ as Redirect URI in the form.
  4. In your registered application go to Token configuration and click Add optional claims. Select ID token and add the following claims:
    • family_name
    • given_name
  5. At the Overview section in your registered application copy the Applicaion (client) ID.
  6. In your registered application go to Certificates & secrets and click New client secret to create a new secret. Copy your Client secret value!
caution

You can view and copy the value of your Client secret only upon creation. Save a backup of your Client secret in a secure place.

  1. Go to NevisAdmin4 Infrastructure → Inventory editor & paste both values.
    • microsoft-client-id: Application (client) ID
    • microsoft-client-secret: Client secret value
  2. Save your nevisAdmin4 changes and deploy your project!!!