Sign in with Passport

Overview

Sign in with Passport makes it easy for users to sign in to your apps and websites using their Passport ID.

Instead of filling out forms, verifying email addresses, and choosing new passwords, they can use Sign in with Passport to set up an account and start using your app right away.

All accounts are protected with two-factor authentication for superior security, and Passport will not track users’ activity in your app or website.

Use Sign In with Passport to:

• Reduce friction and obtain more sign-ups by allowing members to Sign In with Passport, without having the need to create a new account.

• Minimize the costs and time associated with implementing your own login, identity, profile management, and password management.

Getting Started

Authenticating Members

New members logging in to your service for the first time will need to follow the Authenticating with OAuth 2.0 Guide. When requesting an authorization code in Step 2 of the OAuth 2.0 Guide, make sure to request the identity.profile and/or identity.email scopes!

Permission	Name	Description
identity.basic	Required to retrieve the member's lite profile including their id, name, and profile picture.
identity.profile	Required to retrieve the member's complete public profile data.
identity.email	Required to retrieve the member's email addresses.
organizations.memberships	Required to retrieve the member's organizations.

After successful authentication, you will acquire an access token that can be used in the next step of the sign-in process.

If your application does not have these permissions, you can add them through the Developer Portal.

Retrieving Member Profiles

With your newly acquired access token for the authenticated member, you can use the following API request to retrieve the member's profile information.

Sample Request

curl -X GET 'https://auth.onepassport.eu/whoami' \
-H 'Authorization: Bearer {INSERT_TOKEN}'

Request Body

Field	Type	Description
token	string	Required. The string value of the token returned using Client Credential Flow or Authorization Code Flow

Sample Response

{
    "_id":"G3dpGzCrf7XRXwsf9",
    "username":"john.doe",
    "profile":{
        "name":{
            "first":"John",
            "last":"Doe"
        },
        "uavatar":"//www.gravatar.com/avatar/43572c4f5cd2f4532a7c67cd529ceb4b?d=identicon"
    }
}

Retrieving Member Email Addresses

In addition to the member's profile, you may be interested in retrieving the member's email address. The identity.email permission scope allows usage of the following API:

Sample Request

curl -X GET 'https://auth.onepassport.eu/whoami/emails' \
-H 'Authorization: Bearer {INSERT_TOKEN}'

Request Body

Field	Type	Description
token	string	Required. The string value of the token returned using Client Credential Flow or Authorization Code Flow

Sample Response

{
    "_id":"G3dpGzCrf7XRXwsf9",
    "username":"john.doe",
    "emails":[
        {"address":"[email protected]"}
    ],
    "profile":{
        "name":{
            "first":"John",
            "last":"Doe"
        }
    }
}

Retrieving Member complete Profile

Use the API request below to retrieve the member's complete public profile. The identity.profile permission scope is required to use following API:

Sample Request

curl -X GET 'https://auth.onepassport.eu/whoami/profile' \
-H 'Authorization: Bearer {INSERT_TOKEN}'

Request Body

Field	Type	Description
token	string	Required. The string value of the token returned using Client Credential Flow or Authorization Code Flow

Sample Response

{
    "_id":"G3dpGzCrf7XRXwsf9",
    "username":"john.doe",
    "emails":[
        {"address":"[email protected]"}
    ],
    "profile":{
        "name":{
            "first":"John",
            "last":"Doe"
        }
    }
}

Retrieving Member Organizations

In addition to the member's profile, you may be interested in retrieving the member's organizations. The organizations.memberships permission scope allows usage of the following API:

Sample Request

curl -X GET 'https://auth.onepassport.eu/whoami/organizations' \
-H 'Authorization: Bearer {INSERT_TOKEN}'

Request Body

Field	Type	Description
token	string	Required. The string value of the token returned using Client Credential Flow or Authorization Code Flow

Sample Response

[
  {
    _id: 'a22c4ab2da67dd69f56833f7',
    profile: {
      name: 'Accelerace',
      contact_email: '[email protected]',
      logo: 'https://fundingbox-images.s3-eu-central-1.amazonaws.com/xurxo/86F8ggnch4/hpqdx4qkbjslrbmtyl45.png',
      about: 'Accelerace is one of the world’s top 10 seed accelerators. Since 2008 Accelerace has spotted, trained and invested in more than 700 of the most promising Danish and international startups and growth companies. 88% of the companies are still on the market today.\n' +
        '\n' +
        'As partner in the national Scale-Up Denmark initiative, Accelerace scales startups within foodtech, edtech, cleantech, IoT, soundtech, fintech, future of work, medtech, biotech and digital health with help from experienced serial entrepreneurs, mentors, bootcamps and a vast network.\n' +
        '\n' +
        'Accelerace has in its lifetime invested more than 38.8 million USD in promising startups and has launched partnerships with the Novo Nordisk Foundation, Arla, COOP, Nordea, Nykredit, Danske Bank, Bang & Olufsen, Sound Hub Denmark, Arbejdernes Landsbank, Ørsted og Elia among others.\n' +
        '\n' +
        'Accelerace is also organizing the **Nordic NOME (Nordic Mentor Network for Entrepreneurship) mentor network** for life science startups. Read more on www.accelerace.io and www.nome.nu or via email: [email protected]',
      industry: [Array],
      location: 'Copenhagen, Hovedstaden, Denmark',
      tagline: 'Home of the Nordic founders building the great companies of tomorrow',
      website: 'https://www.accelerace.io',
      tags: [Array],
      technologies: [Array]
    },
    type: 'accelerator-incubator',
    slug: 'accelerace'
  }
]

Additional resources

Image resources

Download official Sign In with Passport button images in different sizes and formats for use within your site or application.