Adds an OAuth2 identity to the user, so that they can be logged in with that identity. You need to send the OAuth code or the access token to this endpoint. 1. If no access token is provided, it will use your OAuth2 token URL to exchange the given code for an access token. 2. Then it will use the access token (given by you, or received from step 1) to look up the user on your service using the lookup URL, and expects a JSON object in response with an id
property. 3. It will then save that user id
to the user in our db as a new OAuthIdentity. In this example, we call your lookup URL (let’s say, https://oauth.provider/user?t=<%= accessToken %>
) with the access token (1234
). The lookup URL returns { id: 'abcd' }
in this case, which we save to the user in our db.
The document’s _id
or slug
.
Your OAuth Provider ID.
Will be passed through your lookup URL to get the user ID. Required if no code
.
Will be passed to the OAuth token endpoint to get a token. Required if no accessToken
.
Usually either ‘teacher’ or ‘student’