You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/oauth.md
+7-5Lines changed: 7 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -97,15 +97,17 @@ To obtain the access token:
97
97
}
98
98
```
99
99
100
+
Unless otherwise specified, all fields are mandatory.
101
+
100
102
Field | Description
101
103
------------ | -------------
102
-
KID | The key ID of the public key in the OAuth application. You can find this value in the Overview tab of the OAuth app you created in the Segment app.
103
-
ISS | The identifier of the JWT issuer. This value is `https://oauth2.segment.io` if you're located in the US, or `https://oauth2.eu1.segmentapis.com` if you're located in the EU.
104
-
SUB | The OAuth application ID. You can find this value in the Overview tab of the OAuth app you created in the Segment app.
104
+
KID | The key ID of the public key in the OAuth application. You can find this value in the Segment app by navigating to the Access Management tab and selecting the OAuth app you created. On the Overview tab for your OAuth app, you'll find your Key ID.
105
+
ISS | _(Optional)_ The identifier of the JWT issuer. This value is `https://oauth2.segment.io` if you're located in the US, or `https://oauth2.eu1.segmentapis.com` if you're located in the EU.
106
+
SUB | The OAuth application ID. You can find this value in the Segment app by navigating to the Access Management tab and selecting the OAuth app you created. On the Overview tab for your OAuth app, you'll find your application ID under **App ID**.
105
107
AUD | The intended recipient of the token. This value is `https://oauth2.segment.io` if you're located in the US, or `https://oauth2.eu1.segmentapis.com` if you're located in the EU.
106
-
IAT | (_Optional_) The epoch time in seconds when the token was issued. This is typically set to the current time using `math.floor(Date.now() / 1000)`.
108
+
IAT | The epoch time in seconds when the token was issued. This is typically set using `math.floor(Date.now() / 1000)`.
107
109
EXP | The expiry time of a token, measured in seconds. Tokens are expected to be valid for less than sixty seconds. You can set the expiry of a token using `math.floor(Date.now() / 1000) + 60`.
108
-
JTI | (_Optional_) A case-sensitive string that acts as a [unique identifer for the token](https://www.rfc-editor.org/rfc/rfc7519#section-4.1.7){:target="_blank”}.
110
+
JTI | A case-sensitive string that acts as a [unique identifer for the token](https://www.rfc-editor.org/rfc/rfc7519#section-4.1.7){:target="_blank”}. Segment recommends setting this value with a UUID format to avoid duplicate values between tokens.
109
111
110
112
2. Send a form-url-encoded `POST` request to the regional authorization server's `\token` route with the following parameters:
0 commit comments