Integrating Single Sign-On

Partner Life is our comprehensive portal for partners to manage contracts, support requests, customer information, and policy changes. This guide explains how to integrate your existing authentication system with Partner Life.

Prerequisites​

Before you begin, ensure you have:

• Your API Key
• You have your Partner ID (mentioned in your Partner Life invitation email) - (it looks like: 123000, 23330-2, etc.)
• You have the Partner IDs of your sub-brokers and employee accounts (found in their respective welcome email or in the colleague section of your Partner Life Account)

Integration Steps​

1. Basic Setup​

First, set up access to our GraphQL API as described in the GraphQL API Guide.

2. Generate Magic Links​

Use the createPartnerLifeMagicLink mutation to generate direct access links to Partner Life:

mutation Mutation($input: CreatePartnerLifeMagicLinkInput!) {
  createPartnerLifeMagicLink(input: $input) {
    __typename
    ... on PartnerLifeMagicLink {
      id
      magicLinkUrl
    }
    ... on ErrorInterface {
      message
    }
  }
}

Example input:

{
  "input": {
    "partnerId": "12345",
    "alreadyMultiFactorAuthenticated": true,
    "acceptPartnerLifeTermsAndConditions": true,
    "acknowledgePartnerLifePrivacyPolicy": true
  }
}

3. Authentication Flow​

The basic authentication flow works as follows:

4. Multi-Factor Authentication​

If your system already implements MFA, you can skip Partner Life's MFA check:

Auto-Activation of Accounts​

For new users with a Partner ID but no active account, you can automatically create their account by:

1. Setting both acceptPartnerLifeTermsAndConditions and acknowledgePartnerLifePrivacyPolicy to true
2. Ensuring the user has accepted:
   • Terms and Conditions
   • Privacy Policy

Need Help?​

If you don't have access to Partner Life or need assistance, contact partner support.