auth0 5.11.0 → 5.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/lib/models.d.ts +7 -7
- package/dist/cjs/lib/retry.d.ts +7 -2
- package/dist/cjs/lib/retry.js +35 -5
- package/dist/cjs/management/api/requests/requests.d.ts +28 -4
- package/dist/cjs/management/api/resources/attackProtection/client/Client.d.ts +3 -0
- package/dist/cjs/management/api/resources/attackProtection/client/Client.js +7 -2
- package/dist/cjs/management/api/resources/attackProtection/resources/index.d.ts +1 -0
- package/dist/cjs/management/api/resources/attackProtection/resources/index.js +2 -1
- package/dist/cjs/management/api/resources/attackProtection/resources/phoneProviderProtection/client/Client.d.ts +45 -0
- package/dist/cjs/management/api/resources/attackProtection/resources/phoneProviderProtection/client/Client.js +180 -0
- package/dist/cjs/management/api/resources/attackProtection/resources/phoneProviderProtection/client/index.d.ts +1 -0
- package/dist/cjs/management/api/resources/attackProtection/resources/phoneProviderProtection/client/index.js +2 -0
- package/dist/cjs/management/api/resources/attackProtection/resources/phoneProviderProtection/index.d.ts +1 -0
- package/dist/cjs/management/api/resources/attackProtection/resources/phoneProviderProtection/index.js +17 -0
- package/dist/cjs/management/api/resources/branding/resources/phone/resources/providers/client/Client.d.ts +6 -6
- package/dist/cjs/management/api/resources/branding/resources/phone/resources/providers/client/Client.js +6 -6
- package/dist/cjs/management/api/resources/clientGrants/client/Client.d.ts +4 -4
- package/dist/cjs/management/api/resources/clientGrants/client/Client.js +4 -4
- package/dist/cjs/management/api/resources/clientGrants/resources/organizations/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/clientGrants/resources/organizations/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/clients/client/Client.d.ts +69 -85
- package/dist/cjs/management/api/resources/clients/client/Client.js +71 -85
- package/dist/cjs/management/api/resources/clients/resources/connections/client/Client.d.ts +4 -9
- package/dist/cjs/management/api/resources/clients/resources/connections/client/Client.js +4 -9
- package/dist/cjs/management/api/resources/clients/resources/credentials/client/Client.d.ts +38 -14
- package/dist/cjs/management/api/resources/clients/resources/credentials/client/Client.js +38 -14
- package/dist/cjs/management/api/resources/connectionProfiles/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/connectionProfiles/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/connections/resources/users/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/connections/resources/users/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/customDomains/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/customDomains/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/emailTemplates/client/Client.d.ts +4 -4
- package/dist/cjs/management/api/resources/emailTemplates/client/Client.js +4 -4
- package/dist/cjs/management/api/resources/emails/resources/provider/client/Client.d.ts +50 -81
- package/dist/cjs/management/api/resources/emails/resources/provider/client/Client.js +50 -81
- package/dist/cjs/management/api/resources/groups/resources/members/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/groups/resources/members/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/groups/resources/roles/client/Client.d.ts +5 -3
- package/dist/cjs/management/api/resources/groups/resources/roles/client/Client.js +9 -3
- package/dist/cjs/management/api/resources/keys/resources/signing/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/keys/resources/signing/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/organizations/client/Client.d.ts +2 -0
- package/dist/cjs/management/api/resources/organizations/client/Client.js +6 -0
- package/dist/cjs/management/api/resources/organizations/resources/connections/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/organizations/resources/connections/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/organizations/resources/enabledConnections/client/Client.d.ts +5 -0
- package/dist/cjs/management/api/resources/organizations/resources/enabledConnections/client/Client.js +15 -0
- package/dist/cjs/management/api/resources/organizations/resources/groups/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/organizations/resources/groups/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/organizations/resources/groups/resources/roles/client/Client.d.ts +3 -0
- package/dist/cjs/management/api/resources/organizations/resources/groups/resources/roles/client/Client.js +9 -0
- package/dist/cjs/management/api/resources/organizations/resources/members/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/organizations/resources/members/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/organizations/resources/members/resources/effectiveRoles/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/organizations/resources/members/resources/effectiveRoles/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/organizations/resources/members/resources/effectiveRoles/resources/sources/resources/groups/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/organizations/resources/members/resources/effectiveRoles/resources/sources/resources/groups/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/organizations/resources/members/resources/roles/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/organizations/resources/members/resources/roles/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/refreshTokens/client/Client.d.ts +1 -1
- package/dist/cjs/management/api/resources/refreshTokens/client/Client.js +1 -1
- package/dist/cjs/management/api/resources/roles/resources/groups/client/Client.d.ts +2 -0
- package/dist/cjs/management/api/resources/roles/resources/groups/client/Client.js +6 -0
- package/dist/cjs/management/api/resources/roles/resources/permissions/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/roles/resources/permissions/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/selfServiceProfiles/resources/ssoTicket/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/selfServiceProfiles/resources/ssoTicket/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/tokenExchangeProfiles/client/Client.d.ts +10 -12
- package/dist/cjs/management/api/resources/tokenExchangeProfiles/client/Client.js +12 -12
- package/dist/cjs/management/api/resources/userAttributeProfiles/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/userAttributeProfiles/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/userGrants/client/Client.d.ts +1 -1
- package/dist/cjs/management/api/resources/userGrants/client/Client.js +1 -1
- package/dist/cjs/management/api/resources/users/resources/connectedAccounts/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/users/resources/connectedAccounts/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/users/resources/effectiveRoles/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/users/resources/effectiveRoles/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/users/resources/effectiveRoles/resources/sources/resources/groups/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/users/resources/effectiveRoles/resources/sources/resources/groups/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/users/resources/groups/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/users/resources/groups/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/users/resources/organizations/client/Client.d.ts +1 -0
- package/dist/cjs/management/api/resources/users/resources/organizations/client/Client.js +3 -0
- package/dist/cjs/management/api/resources/users/resources/permissions/client/Client.d.ts +2 -0
- package/dist/cjs/management/api/resources/users/resources/permissions/client/Client.js +6 -0
- package/dist/cjs/management/api/resources/users/resources/roles/client/Client.d.ts +2 -0
- package/dist/cjs/management/api/resources/users/resources/roles/client/Client.js +6 -0
- package/dist/cjs/management/api/types/types.d.ts +281 -109
- package/dist/cjs/management/api/types/types.js +36 -46
- package/dist/cjs/management/version.d.ts +1 -1
- package/dist/cjs/management/version.js +1 -1
- package/dist/esm/lib/models.d.mts +7 -7
- package/dist/esm/lib/retry.d.mts +7 -2
- package/dist/esm/lib/retry.mjs +35 -5
- package/dist/esm/management/api/requests/requests.d.mts +28 -4
- package/dist/esm/management/api/resources/attackProtection/client/Client.d.mts +3 -0
- package/dist/esm/management/api/resources/attackProtection/client/Client.mjs +5 -0
- package/dist/esm/management/api/resources/attackProtection/resources/index.d.mts +1 -0
- package/dist/esm/management/api/resources/attackProtection/resources/index.mjs +1 -0
- package/dist/esm/management/api/resources/attackProtection/resources/phoneProviderProtection/client/Client.d.mts +45 -0
- package/dist/esm/management/api/resources/attackProtection/resources/phoneProviderProtection/client/Client.mjs +143 -0
- package/dist/esm/management/api/resources/attackProtection/resources/phoneProviderProtection/client/index.d.mts +1 -0
- package/dist/esm/management/api/resources/attackProtection/resources/phoneProviderProtection/client/index.mjs +1 -0
- package/dist/esm/management/api/resources/attackProtection/resources/phoneProviderProtection/index.d.mts +1 -0
- package/dist/esm/management/api/resources/attackProtection/resources/phoneProviderProtection/index.mjs +1 -0
- package/dist/esm/management/api/resources/branding/resources/phone/resources/providers/client/Client.d.mts +6 -6
- package/dist/esm/management/api/resources/branding/resources/phone/resources/providers/client/Client.mjs +6 -6
- package/dist/esm/management/api/resources/clientGrants/client/Client.d.mts +4 -4
- package/dist/esm/management/api/resources/clientGrants/client/Client.mjs +4 -4
- package/dist/esm/management/api/resources/clientGrants/resources/organizations/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/clientGrants/resources/organizations/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/clients/client/Client.d.mts +69 -85
- package/dist/esm/management/api/resources/clients/client/Client.mjs +71 -85
- package/dist/esm/management/api/resources/clients/resources/connections/client/Client.d.mts +4 -9
- package/dist/esm/management/api/resources/clients/resources/connections/client/Client.mjs +4 -9
- package/dist/esm/management/api/resources/clients/resources/credentials/client/Client.d.mts +38 -14
- package/dist/esm/management/api/resources/clients/resources/credentials/client/Client.mjs +38 -14
- package/dist/esm/management/api/resources/connectionProfiles/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/connectionProfiles/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/connections/resources/users/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/connections/resources/users/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/customDomains/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/customDomains/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/emailTemplates/client/Client.d.mts +4 -4
- package/dist/esm/management/api/resources/emailTemplates/client/Client.mjs +4 -4
- package/dist/esm/management/api/resources/emails/resources/provider/client/Client.d.mts +50 -81
- package/dist/esm/management/api/resources/emails/resources/provider/client/Client.mjs +50 -81
- package/dist/esm/management/api/resources/groups/resources/members/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/groups/resources/members/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/groups/resources/roles/client/Client.d.mts +5 -3
- package/dist/esm/management/api/resources/groups/resources/roles/client/Client.mjs +9 -3
- package/dist/esm/management/api/resources/keys/resources/signing/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/keys/resources/signing/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/organizations/client/Client.d.mts +2 -0
- package/dist/esm/management/api/resources/organizations/client/Client.mjs +6 -0
- package/dist/esm/management/api/resources/organizations/resources/connections/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/organizations/resources/connections/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/organizations/resources/enabledConnections/client/Client.d.mts +5 -0
- package/dist/esm/management/api/resources/organizations/resources/enabledConnections/client/Client.mjs +15 -0
- package/dist/esm/management/api/resources/organizations/resources/groups/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/organizations/resources/groups/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/organizations/resources/groups/resources/roles/client/Client.d.mts +3 -0
- package/dist/esm/management/api/resources/organizations/resources/groups/resources/roles/client/Client.mjs +9 -0
- package/dist/esm/management/api/resources/organizations/resources/members/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/organizations/resources/members/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/organizations/resources/members/resources/effectiveRoles/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/organizations/resources/members/resources/effectiveRoles/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/organizations/resources/members/resources/effectiveRoles/resources/sources/resources/groups/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/organizations/resources/members/resources/effectiveRoles/resources/sources/resources/groups/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/organizations/resources/members/resources/roles/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/organizations/resources/members/resources/roles/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/refreshTokens/client/Client.d.mts +1 -1
- package/dist/esm/management/api/resources/refreshTokens/client/Client.mjs +1 -1
- package/dist/esm/management/api/resources/roles/resources/groups/client/Client.d.mts +2 -0
- package/dist/esm/management/api/resources/roles/resources/groups/client/Client.mjs +6 -0
- package/dist/esm/management/api/resources/roles/resources/permissions/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/roles/resources/permissions/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/selfServiceProfiles/resources/ssoTicket/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/selfServiceProfiles/resources/ssoTicket/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/tokenExchangeProfiles/client/Client.d.mts +10 -12
- package/dist/esm/management/api/resources/tokenExchangeProfiles/client/Client.mjs +12 -12
- package/dist/esm/management/api/resources/userAttributeProfiles/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/userAttributeProfiles/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/userGrants/client/Client.d.mts +1 -1
- package/dist/esm/management/api/resources/userGrants/client/Client.mjs +1 -1
- package/dist/esm/management/api/resources/users/resources/connectedAccounts/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/users/resources/connectedAccounts/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/users/resources/effectiveRoles/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/users/resources/effectiveRoles/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/users/resources/effectiveRoles/resources/sources/resources/groups/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/users/resources/effectiveRoles/resources/sources/resources/groups/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/users/resources/groups/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/users/resources/groups/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/users/resources/organizations/client/Client.d.mts +1 -0
- package/dist/esm/management/api/resources/users/resources/organizations/client/Client.mjs +3 -0
- package/dist/esm/management/api/resources/users/resources/permissions/client/Client.d.mts +2 -0
- package/dist/esm/management/api/resources/users/resources/permissions/client/Client.mjs +6 -0
- package/dist/esm/management/api/resources/users/resources/roles/client/Client.d.mts +2 -0
- package/dist/esm/management/api/resources/users/resources/roles/client/Client.mjs +6 -0
- package/dist/esm/management/api/types/types.d.mts +281 -109
- package/dist/esm/management/api/types/types.mjs +23 -33
- package/dist/esm/management/version.d.mts +1 -1
- package/dist/esm/management/version.mjs +1 -1
- package/package.json +1 -1
- package/reference.md +349 -265
package/reference.md
CHANGED
|
@@ -640,7 +640,7 @@ await client.branding.update();
|
|
|
640
640
|
<dl>
|
|
641
641
|
<dd>
|
|
642
642
|
|
|
643
|
-
Retrieve a list of
|
|
643
|
+
Retrieve a list of [client grants](https://auth0.com/docs/get-started/applications/application-access-to-apis-client-grants), including the scopes associated with the application/API pair.
|
|
644
644
|
|
|
645
645
|
</dd>
|
|
646
646
|
</dl>
|
|
@@ -731,7 +731,7 @@ const response = page.response;
|
|
|
731
731
|
<dl>
|
|
732
732
|
<dd>
|
|
733
733
|
|
|
734
|
-
Create a client grant for a machine-to-machine login flow. To learn more, read
|
|
734
|
+
Create a client grant for a machine-to-machine login flow. To learn more, read [Client Credential Flow](https://www.auth0.com/docs/get-started/authentication-and-authorization-flow/client-credentials-flow).
|
|
735
735
|
|
|
736
736
|
</dd>
|
|
737
737
|
</dl>
|
|
@@ -796,7 +796,7 @@ await client.clientGrants.create({
|
|
|
796
796
|
<dl>
|
|
797
797
|
<dd>
|
|
798
798
|
|
|
799
|
-
Retrieve a single
|
|
799
|
+
Retrieve a single [client grant](https://auth0.com/docs/get-started/applications/application-access-to-apis-client-grants), including the
|
|
800
800
|
scopes associated with the application/API pair.
|
|
801
801
|
|
|
802
802
|
</dd>
|
|
@@ -860,7 +860,7 @@ await client.clientGrants.get("id");
|
|
|
860
860
|
<dl>
|
|
861
861
|
<dd>
|
|
862
862
|
|
|
863
|
-
Delete the
|
|
863
|
+
Delete the [Client Credential Flow](https://www.auth0.com/docs/get-started/authentication-and-authorization-flow/client-credentials-flow) from your machine-to-machine application.
|
|
864
864
|
|
|
865
865
|
</dd>
|
|
866
866
|
</dl>
|
|
@@ -997,42 +997,34 @@ await client.clientGrants.update("id");
|
|
|
997
997
|
<dd>
|
|
998
998
|
|
|
999
999
|
Retrieve clients (applications and SSO integrations) matching provided filters. A list of fields to include or exclude may also be specified.
|
|
1000
|
-
For more information, read
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
|
|
1017
|
-
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
|
|
1021
|
-
|
|
1022
|
-
|
|
1023
|
-
|
|
1024
|
-
</
|
|
1025
|
-
|
|
1026
|
-
|
|
1027
|
-
|
|
1028
|
-
<code>encryption_key</code>, <code>encryption_key.pub</code>, <code>encryption_key.cert</code>,
|
|
1029
|
-
<code>client_secret</code>, <code>client_authentication_methods</code> and <code>signing_key</code>.
|
|
1030
|
-
</li>
|
|
1031
|
-
</ul>
|
|
1032
|
-
</dd>
|
|
1033
|
-
</dl>
|
|
1034
|
-
</dd>
|
|
1035
|
-
</dl>
|
|
1000
|
+
For more information, read [Applications in Auth0](https://www.auth0.com/docs/get-started/applications) and [Single Sign-On](https://www.auth0.com/docs/authenticate/single-sign-on).
|
|
1001
|
+
|
|
1002
|
+
- The following can be retrieved with any scope:
|
|
1003
|
+
`client_id`, `app_type`, `name`, and `description`.
|
|
1004
|
+
- The following properties can only be retrieved with the `read:clients` or
|
|
1005
|
+
`read:client_keys` scope:
|
|
1006
|
+
`callbacks`, `oidc_logout`, `allowed_origins`,
|
|
1007
|
+
`web_origins`, `tenant`, `global`, `config_route`,
|
|
1008
|
+
`callback_url_template`, `jwt_configuration`,
|
|
1009
|
+
`jwt_configuration.lifetime_in_seconds`, `jwt_configuration.secret_encoded`,
|
|
1010
|
+
`jwt_configuration.scopes`, `jwt_configuration.alg`, `api_type`,
|
|
1011
|
+
`logo_uri`, `allowed_clients`, `owners`, `custom_login_page`,
|
|
1012
|
+
`custom_login_page_off`, `sso`, `addons`, `form_template`,
|
|
1013
|
+
`custom_login_page_codeview`, `resource_servers`, `client_metadata`,
|
|
1014
|
+
`mobile`, `mobile.android`, `mobile.ios`, `allowed_logout_urls`,
|
|
1015
|
+
`token_endpoint_auth_method`, `is_first_party`, `oidc_conformant`,
|
|
1016
|
+
`is_token_endpoint_ip_header_trusted`, `initiate_login_uri`, `grant_types`,
|
|
1017
|
+
`refresh_token`, `refresh_token.rotation_type`, `refresh_token.expiration_type`,
|
|
1018
|
+
`refresh_token.leeway`, `refresh_token.token_lifetime`, `refresh_token.policies`, `organization_usage`,
|
|
1019
|
+
`organization_require_behavior`.
|
|
1020
|
+
- The following properties can only be retrieved with the
|
|
1021
|
+
`read:client_keys` or `read:client_credentials` scope:
|
|
1022
|
+
`encryption_key`, `encryption_key.pub`, `encryption_key.cert`,
|
|
1023
|
+
`client_secret`, `client_authentication_methods` and `signing_key`.
|
|
1024
|
+
</dd>
|
|
1025
|
+
</dl>
|
|
1026
|
+
</dd>
|
|
1027
|
+
</dl>
|
|
1036
1028
|
|
|
1037
1029
|
#### 🔌 Usage
|
|
1038
1030
|
|
|
@@ -1124,21 +1116,22 @@ const response = page.response;
|
|
|
1124
1116
|
<dl>
|
|
1125
1117
|
<dd>
|
|
1126
1118
|
|
|
1127
|
-
Create a new client (application or SSO integration). For more information, read
|
|
1128
|
-
|
|
1119
|
+
Create a new client (application or SSO integration). For more information, read [Create Applications](https://www.auth0.com/docs/get-started/auth0-overview/create-applications)
|
|
1120
|
+
[API Endpoints for Single Sign-On](https://www.auth0.com/docs/authenticate/single-sign-on/api-endpoints-for-single-sign-on).
|
|
1129
1121
|
|
|
1130
1122
|
Notes:
|
|
1131
1123
|
|
|
1132
1124
|
- We recommend leaving the `client_secret` parameter unspecified to allow the generation of a safe secret.
|
|
1133
|
-
- The
|
|
1134
|
-
|
|
1125
|
+
- The `client_authentication_methods` and `token_endpoint_auth_method` properties are mutually exclusive. Use
|
|
1126
|
+
`client_authentication_methods` to configure the client with Private Key JWT authentication method. Otherwise, use `token_endpoint_auth_method`
|
|
1135
1127
|
to configure the client with client secret (basic or post) or with no authentication method (none).
|
|
1136
|
-
- When using
|
|
1128
|
+
- When using `client_authentication_methods` to configure the client with Private Key JWT authentication method, specify fully defined credentials.
|
|
1137
1129
|
These credentials will be automatically enabled for Private Key JWT authentication on the client.
|
|
1138
|
-
- To configure
|
|
1139
|
-
- To configure
|
|
1130
|
+
- To configure `client_authentication_methods`, the `create:client_credentials` scope is required.
|
|
1131
|
+
- To configure `client_authentication_methods`, the property `jwt_configuration.alg` must be set to RS256.
|
|
1132
|
+
|
|
1133
|
+
SSO Integrations created via this endpoint will accept login requests and share user profile information.
|
|
1140
1134
|
|
|
1141
|
-
<div class="alert alert-warning">SSO Integrations created via this endpoint will accept login requests and share user profile information.</div>
|
|
1142
1135
|
</dd>
|
|
1143
1136
|
</dl>
|
|
1144
1137
|
</dd>
|
|
@@ -1272,21 +1265,19 @@ await client.clients.previewCimdMetadata({
|
|
|
1272
1265
|
Idempotent registration for Client ID Metadata Document (CIMD) clients.
|
|
1273
1266
|
Uses external_client_id as the unique identifier for upsert operations.
|
|
1274
1267
|
|
|
1275
|
-
|
|
1276
|
-
|
|
1268
|
+
**Create:** Returns 201 when a new client is created (requires `create:clients` scope).
|
|
1269
|
+
**Update:** Returns 200 when an existing client is updated (requires `update:clients` scope).
|
|
1277
1270
|
|
|
1278
1271
|
This endpoint automatically:
|
|
1279
1272
|
|
|
1280
|
-
|
|
1281
|
-
|
|
1282
|
-
|
|
1283
|
-
|
|
1284
|
-
|
|
1285
|
-
</
|
|
1286
|
-
</dd>
|
|
1287
|
-
</dl>
|
|
1288
|
-
</dd>
|
|
1289
|
-
</dl>
|
|
1273
|
+
- Fetches and validates the metadata document
|
|
1274
|
+
- Maps CIMD fields to Auth0 client configuration
|
|
1275
|
+
- Creates/rotates credentials from the JWKS
|
|
1276
|
+
- Enforces CIMD security policies (HTTPS-only, no shared secrets)
|
|
1277
|
+
</dd>
|
|
1278
|
+
</dl>
|
|
1279
|
+
</dd>
|
|
1280
|
+
</dl>
|
|
1290
1281
|
|
|
1291
1282
|
#### 🔌 Usage
|
|
1292
1283
|
|
|
@@ -1347,41 +1338,33 @@ await client.clients.registerCimdClient({
|
|
|
1347
1338
|
<dd>
|
|
1348
1339
|
|
|
1349
1340
|
Retrieve client details by ID. Clients are SSO connections or Applications linked with your Auth0 tenant. A list of fields to include or exclude may also be specified.
|
|
1350
|
-
For more information, read
|
|
1351
|
-
|
|
1352
|
-
|
|
1353
|
-
|
|
1354
|
-
|
|
1355
|
-
|
|
1356
|
-
|
|
1357
|
-
|
|
1358
|
-
|
|
1359
|
-
|
|
1360
|
-
|
|
1361
|
-
|
|
1362
|
-
|
|
1363
|
-
|
|
1364
|
-
|
|
1365
|
-
|
|
1366
|
-
|
|
1367
|
-
|
|
1368
|
-
|
|
1369
|
-
|
|
1370
|
-
|
|
1371
|
-
|
|
1372
|
-
|
|
1373
|
-
|
|
1374
|
-
</
|
|
1375
|
-
|
|
1376
|
-
|
|
1377
|
-
<code>encryption_key</code>, <code>encryption_key.pub</code>, <code>encryption_key.cert</code>,
|
|
1378
|
-
<code>client_secret</code>, <code>client_authentication_methods</code> and <code>signing_key</code>.
|
|
1379
|
-
</li>
|
|
1380
|
-
</ul>
|
|
1381
|
-
</dd>
|
|
1382
|
-
</dl>
|
|
1383
|
-
</dd>
|
|
1384
|
-
</dl>
|
|
1341
|
+
For more information, read [Applications in Auth0](https://www.auth0.com/docs/get-started/applications) and [Single Sign-On](https://www.auth0.com/docs/authenticate/single-sign-on).
|
|
1342
|
+
|
|
1343
|
+
- The following properties can be retrieved with any of the scopes:
|
|
1344
|
+
`client_id`, `app_type`, `name`, and `description`.
|
|
1345
|
+
- The following properties can only be retrieved with the `read:clients` or
|
|
1346
|
+
`read:client_keys` scopes:
|
|
1347
|
+
`callbacks`, `oidc_logout`, `allowed_origins`,
|
|
1348
|
+
`web_origins`, `tenant`, `global`, `config_route`,
|
|
1349
|
+
`callback_url_template`, `jwt_configuration`,
|
|
1350
|
+
`jwt_configuration.lifetime_in_seconds`, `jwt_configuration.secret_encoded`,
|
|
1351
|
+
`jwt_configuration.scopes`, `jwt_configuration.alg`, `api_type`,
|
|
1352
|
+
`logo_uri`, `allowed_clients`, `owners`, `custom_login_page`,
|
|
1353
|
+
`custom_login_page_off`, `sso`, `addons`, `form_template`,
|
|
1354
|
+
`custom_login_page_codeview`, `resource_servers`, `client_metadata`,
|
|
1355
|
+
`mobile`, `mobile.android`, `mobile.ios`, `allowed_logout_urls`,
|
|
1356
|
+
`token_endpoint_auth_method`, `is_first_party`, `oidc_conformant`,
|
|
1357
|
+
`is_token_endpoint_ip_header_trusted`, `initiate_login_uri`, `grant_types`,
|
|
1358
|
+
`refresh_token`, `refresh_token.rotation_type`, `refresh_token.expiration_type`,
|
|
1359
|
+
`refresh_token.leeway`, `refresh_token.token_lifetime`, `refresh_token.policies`, `organization_usage`,
|
|
1360
|
+
`organization_require_behavior`.
|
|
1361
|
+
- The following properties can only be retrieved with the `read:client_keys` or `read:client_credentials` scopes:
|
|
1362
|
+
`encryption_key`, `encryption_key.pub`, `encryption_key.cert`,
|
|
1363
|
+
`client_secret`, `client_authentication_methods` and `signing_key`.
|
|
1364
|
+
</dd>
|
|
1365
|
+
</dl>
|
|
1366
|
+
</dd>
|
|
1367
|
+
</dl>
|
|
1385
1368
|
|
|
1386
1369
|
#### 🔌 Usage
|
|
1387
1370
|
|
|
@@ -1513,16 +1496,16 @@ await client.clients.delete("id");
|
|
|
1513
1496
|
<dl>
|
|
1514
1497
|
<dd>
|
|
1515
1498
|
|
|
1516
|
-
Updates a client's settings. For more information, read
|
|
1499
|
+
Updates a client's settings. For more information, read [Applications in Auth0](https://www.auth0.com/docs/get-started/applications) and [Single Sign-On](https://www.auth0.com/docs/authenticate/single-sign-on).
|
|
1517
1500
|
|
|
1518
1501
|
Notes:
|
|
1519
1502
|
|
|
1520
1503
|
- The `client_secret` and `signing_key` attributes can only be updated with the `update:client_keys` scope.
|
|
1521
|
-
- The
|
|
1522
|
-
- When using
|
|
1523
|
-
- To configure
|
|
1524
|
-
- To configure
|
|
1525
|
-
- To change a client's
|
|
1504
|
+
- The `client_authentication_methods` and `token_endpoint_auth_method` properties are mutually exclusive. Use `client_authentication_methods` to configure the client with Private Key JWT authentication method. Otherwise, use `token_endpoint_auth_method` to configure the client with client secret (basic or post) or with no authentication method (none).
|
|
1505
|
+
- When using `client_authentication_methods` to configure the client with Private Key JWT authentication method, only specify the credential IDs that were generated when creating the credentials on the client.
|
|
1506
|
+
- To configure `client_authentication_methods`, the `update:client_credentials` scope is required.
|
|
1507
|
+
- To configure `client_authentication_methods`, the property `jwt_configuration.alg` must be set to RS256.
|
|
1508
|
+
- To change a client's `is_first_party` property to `false`, the `organization_usage` and `organization_require_behavior` properties must be unset.
|
|
1526
1509
|
</dd>
|
|
1527
1510
|
</dl>
|
|
1528
1511
|
</dd>
|
|
@@ -1596,7 +1579,7 @@ Rotate a client secret.
|
|
|
1596
1579
|
|
|
1597
1580
|
This endpoint cannot be used with clients configured with Private Key JWT authentication method (client_authentication_methods configured with private_key_jwt). The generated secret is NOT base64 encoded.
|
|
1598
1581
|
|
|
1599
|
-
For more information, read
|
|
1582
|
+
For more information, read [Rotate Client Secrets](https://www.auth0.com/docs/get-started/applications/rotate-client-secret).
|
|
1600
1583
|
|
|
1601
1584
|
</dd>
|
|
1602
1585
|
</dl>
|
|
@@ -3494,7 +3477,7 @@ await client.emailTemplates.create({
|
|
|
3494
3477
|
<dl>
|
|
3495
3478
|
<dd>
|
|
3496
3479
|
|
|
3497
|
-
Retrieve an email template by pre-defined name. These names are `verify_email`, `verify_email_by_code`, `reset_email`, `reset_email_by_code`, `welcome_email`, `blocked_account`, `stolen_credentials`, `enrollment_email`, `mfa_oob_code`, `user_invitation`, and `async_approval`. The names `change_password`, and `password_reset` are also supported for legacy scenarios.
|
|
3480
|
+
Retrieve an email template by pre-defined name. These names are `verify_email`, `verify_email_by_code`, `auth_email_by_code`, `reset_email`, `reset_email_by_code`, `welcome_email`, `blocked_account`, `stolen_credentials`, `enrollment_email`, `mfa_oob_code`, `user_invitation`, and `async_approval`. The names `change_password`, and `password_reset` are also supported for legacy scenarios.
|
|
3498
3481
|
|
|
3499
3482
|
</dd>
|
|
3500
3483
|
</dl>
|
|
@@ -3526,7 +3509,7 @@ await client.emailTemplates.get("verify_email");
|
|
|
3526
3509
|
<dl>
|
|
3527
3510
|
<dd>
|
|
3528
3511
|
|
|
3529
|
-
**templateName:** `Management.EmailTemplateNameEnum` — Template name. Can be `verify_email`, `verify_email_by_code`, `reset_email`, `reset_email_by_code`, `welcome_email`, `blocked_account`, `stolen_credentials`, `enrollment_email`, `mfa_oob_code`, `user_invitation`, `async_approval`, `change_password` (legacy), or `password_reset` (legacy).
|
|
3512
|
+
**templateName:** `Management.EmailTemplateNameEnum` — Template name. Can be `verify_email`, `verify_email_by_code`, `auth_email_by_code`, `reset_email`, `reset_email_by_code`, `welcome_email`, `blocked_account`, `stolen_credentials`, `enrollment_email`, `mfa_oob_code`, `user_invitation`, `async_approval`, `change_password` (legacy), or `password_reset` (legacy).
|
|
3530
3513
|
|
|
3531
3514
|
</dd>
|
|
3532
3515
|
</dl>
|
|
@@ -3591,7 +3574,7 @@ await client.emailTemplates.set("verify_email", {
|
|
|
3591
3574
|
<dl>
|
|
3592
3575
|
<dd>
|
|
3593
3576
|
|
|
3594
|
-
**templateName:** `Management.EmailTemplateNameEnum` — Template name. Can be `verify_email`, `verify_email_by_code`, `reset_email`, `reset_email_by_code`, `welcome_email`, `blocked_account`, `stolen_credentials`, `enrollment_email`, `mfa_oob_code`, `user_invitation`, `async_approval`, `change_password` (legacy), or `password_reset` (legacy).
|
|
3577
|
+
**templateName:** `Management.EmailTemplateNameEnum` — Template name. Can be `verify_email`, `verify_email_by_code`, `auth_email_by_code`, `reset_email`, `reset_email_by_code`, `welcome_email`, `blocked_account`, `stolen_credentials`, `enrollment_email`, `mfa_oob_code`, `user_invitation`, `async_approval`, `change_password` (legacy), or `password_reset` (legacy).
|
|
3595
3578
|
|
|
3596
3579
|
</dd>
|
|
3597
3580
|
</dl>
|
|
@@ -3662,7 +3645,7 @@ await client.emailTemplates.update("verify_email");
|
|
|
3662
3645
|
<dl>
|
|
3663
3646
|
<dd>
|
|
3664
3647
|
|
|
3665
|
-
**templateName:** `Management.EmailTemplateNameEnum` — Template name. Can be `verify_email`, `verify_email_by_code`, `reset_email`, `reset_email_by_code`, `welcome_email`, `blocked_account`, `stolen_credentials`, `enrollment_email`, `mfa_oob_code`, `user_invitation`, `async_approval`, `change_password` (legacy), or `password_reset` (legacy).
|
|
3648
|
+
**templateName:** `Management.EmailTemplateNameEnum` — Template name. Can be `verify_email`, `verify_email_by_code`, `auth_email_by_code`, `reset_email`, `reset_email_by_code`, `welcome_email`, `blocked_account`, `stolen_credentials`, `enrollment_email`, `mfa_oob_code`, `user_invitation`, `async_approval`, `change_password` (legacy), or `password_reset` (legacy).
|
|
3666
3649
|
|
|
3667
3650
|
</dd>
|
|
3668
3651
|
</dl>
|
|
@@ -4682,7 +4665,7 @@ await client.forms.update("id");
|
|
|
4682
4665
|
<dl>
|
|
4683
4666
|
<dd>
|
|
4684
4667
|
|
|
4685
|
-
Retrieve the
|
|
4668
|
+
Retrieve the [grants](https://auth0.com/docs/api-auth/which-oauth-flow-to-use) associated with your account.
|
|
4686
4669
|
|
|
4687
4670
|
</dd>
|
|
4688
4671
|
</dl>
|
|
@@ -7911,7 +7894,7 @@ const response = page.response;
|
|
|
7911
7894
|
<dl>
|
|
7912
7895
|
<dd>
|
|
7913
7896
|
|
|
7914
|
-
Revoke refresh tokens in bulk by ID list, user, user+client, or client.
|
|
7897
|
+
Revoke refresh tokens in bulk by ID list, user, user+client, or user+client+audience.
|
|
7915
7898
|
|
|
7916
7899
|
</dd>
|
|
7917
7900
|
</dl>
|
|
@@ -10437,16 +10420,14 @@ await client.tickets.changePassword();
|
|
|
10437
10420
|
|
|
10438
10421
|
Retrieve a list of all Token Exchange Profiles available in your tenant.
|
|
10439
10422
|
|
|
10440
|
-
By using this feature, you agree to the applicable Free Trial terms in
|
|
10423
|
+
By using this feature, you agree to the applicable Free Trial terms in [Okta’s Master Subscription Agreement](https://www.okta.com/legal/). It is your responsibility to securely validate the user’s subject_token. See [User Guide](https://auth0.com/docs/authenticate/custom-token-exchange) for more details.
|
|
10441
10424
|
|
|
10442
10425
|
This endpoint supports Checkpoint pagination. To search by checkpoint, use the following parameters:
|
|
10443
10426
|
|
|
10444
|
-
|
|
10445
|
-
|
|
10446
|
-
<li><code>take</code>: The total amount of entries to retrieve when using the from parameter. Defaults to 50.</li>
|
|
10447
|
-
</ul>
|
|
10427
|
+
- `from`: Optional id from which to start selection.
|
|
10428
|
+
- `take`: The total amount of entries to retrieve when using the from parameter. Defaults to 50.
|
|
10448
10429
|
|
|
10449
|
-
|
|
10430
|
+
**Note**: The first time you call this endpoint using checkpoint pagination, omit the `from` parameter. If there are more results, a `next` value is included in the response. You can use this for subsequent API calls. When `next` is no longer included in the response, no pages are remaining.
|
|
10450
10431
|
|
|
10451
10432
|
</dd>
|
|
10452
10433
|
</dl>
|
|
@@ -10529,7 +10510,7 @@ const response = page.response;
|
|
|
10529
10510
|
|
|
10530
10511
|
Create a new Token Exchange Profile within your tenant.
|
|
10531
10512
|
|
|
10532
|
-
By using this feature, you agree to the applicable Free Trial terms in
|
|
10513
|
+
By using this feature, you agree to the applicable Free Trial terms in [Okta’s Master Subscription Agreement](https://www.okta.com/legal/). It is your responsibility to securely validate the user’s subject_token. See [User Guide](https://auth0.com/docs/authenticate/custom-token-exchange) for more details.
|
|
10533
10514
|
|
|
10534
10515
|
</dd>
|
|
10535
10516
|
</dl>
|
|
@@ -10599,7 +10580,7 @@ await client.tokenExchangeProfiles.create({
|
|
|
10599
10580
|
|
|
10600
10581
|
Retrieve details about a single Token Exchange Profile specified by ID.
|
|
10601
10582
|
|
|
10602
|
-
By using this feature, you agree to the applicable Free Trial terms in
|
|
10583
|
+
By using this feature, you agree to the applicable Free Trial terms in [Okta’s Master Subscription Agreement](https://www.okta.com/legal/). It is your responsibility to securely validate the user’s subject_token. See [User Guide](https://auth0.com/docs/authenticate/custom-token-exchange) for more details.
|
|
10603
10584
|
|
|
10604
10585
|
</dd>
|
|
10605
10586
|
</dl>
|
|
@@ -10664,7 +10645,7 @@ await client.tokenExchangeProfiles.get("id");
|
|
|
10664
10645
|
|
|
10665
10646
|
Delete a Token Exchange Profile within your tenant.
|
|
10666
10647
|
|
|
10667
|
-
By using this feature, you agree to the applicable Free Trial terms in
|
|
10648
|
+
By using this feature, you agree to the applicable Free Trial terms in [Okta's Master Subscription Agreement](https://www.okta.com/legal/). It is your responsibility to securely validate the user's subject_token. See [User Guide](https://auth0.com/docs/authenticate/custom-token-exchange) for more details.
|
|
10668
10649
|
|
|
10669
10650
|
</dd>
|
|
10670
10651
|
</dl>
|
|
@@ -10729,7 +10710,7 @@ await client.tokenExchangeProfiles.delete("id");
|
|
|
10729
10710
|
|
|
10730
10711
|
Update a Token Exchange Profile within your tenant.
|
|
10731
10712
|
|
|
10732
|
-
By using this feature, you agree to the applicable Free Trial terms in
|
|
10713
|
+
By using this feature, you agree to the applicable Free Trial terms in [Okta's Master Subscription Agreement](https://www.okta.com/legal/). It is your responsibility to securely validate the user's subject_token. See [User Guide](https://auth0.com/docs/authenticate/custom-token-exchange) for more details.
|
|
10733
10714
|
|
|
10734
10715
|
</dd>
|
|
10735
10716
|
</dl>
|
|
@@ -14080,6 +14061,128 @@ await client.attackProtection.captcha.update();
|
|
|
14080
14061
|
</dl>
|
|
14081
14062
|
</details>
|
|
14082
14063
|
|
|
14064
|
+
## AttackProtection PhoneProviderProtection
|
|
14065
|
+
|
|
14066
|
+
<details><summary><code>client.attackProtection.phoneProviderProtection.<a href="/src/management/api/resources/attackProtection/resources/phoneProviderProtection/client/Client.ts">get</a>() -> Management.GetPhoneProviderProtectionResponseContent</code></summary>
|
|
14067
|
+
<dl>
|
|
14068
|
+
<dd>
|
|
14069
|
+
|
|
14070
|
+
#### 📝 Description
|
|
14071
|
+
|
|
14072
|
+
<dl>
|
|
14073
|
+
<dd>
|
|
14074
|
+
|
|
14075
|
+
<dl>
|
|
14076
|
+
<dd>
|
|
14077
|
+
|
|
14078
|
+
Get the phone provider protection configuration for a tenant.
|
|
14079
|
+
|
|
14080
|
+
</dd>
|
|
14081
|
+
</dl>
|
|
14082
|
+
</dd>
|
|
14083
|
+
</dl>
|
|
14084
|
+
|
|
14085
|
+
#### 🔌 Usage
|
|
14086
|
+
|
|
14087
|
+
<dl>
|
|
14088
|
+
<dd>
|
|
14089
|
+
|
|
14090
|
+
<dl>
|
|
14091
|
+
<dd>
|
|
14092
|
+
|
|
14093
|
+
```typescript
|
|
14094
|
+
await client.attackProtection.phoneProviderProtection.get();
|
|
14095
|
+
```
|
|
14096
|
+
|
|
14097
|
+
</dd>
|
|
14098
|
+
</dl>
|
|
14099
|
+
</dd>
|
|
14100
|
+
</dl>
|
|
14101
|
+
|
|
14102
|
+
#### ⚙️ Parameters
|
|
14103
|
+
|
|
14104
|
+
<dl>
|
|
14105
|
+
<dd>
|
|
14106
|
+
|
|
14107
|
+
<dl>
|
|
14108
|
+
<dd>
|
|
14109
|
+
|
|
14110
|
+
**requestOptions:** `PhoneProviderProtectionClient.RequestOptions`
|
|
14111
|
+
|
|
14112
|
+
</dd>
|
|
14113
|
+
</dl>
|
|
14114
|
+
</dd>
|
|
14115
|
+
</dl>
|
|
14116
|
+
|
|
14117
|
+
</dd>
|
|
14118
|
+
</dl>
|
|
14119
|
+
</details>
|
|
14120
|
+
|
|
14121
|
+
<details><summary><code>client.attackProtection.phoneProviderProtection.<a href="/src/management/api/resources/attackProtection/resources/phoneProviderProtection/client/Client.ts">patch</a>({ ...params }) -> Management.PatchPhoneProviderProtectionResponseContent</code></summary>
|
|
14122
|
+
<dl>
|
|
14123
|
+
<dd>
|
|
14124
|
+
|
|
14125
|
+
#### 📝 Description
|
|
14126
|
+
|
|
14127
|
+
<dl>
|
|
14128
|
+
<dd>
|
|
14129
|
+
|
|
14130
|
+
<dl>
|
|
14131
|
+
<dd>
|
|
14132
|
+
|
|
14133
|
+
Update the phone provider protection configuration for a tenant.
|
|
14134
|
+
|
|
14135
|
+
</dd>
|
|
14136
|
+
</dl>
|
|
14137
|
+
</dd>
|
|
14138
|
+
</dl>
|
|
14139
|
+
|
|
14140
|
+
#### 🔌 Usage
|
|
14141
|
+
|
|
14142
|
+
<dl>
|
|
14143
|
+
<dd>
|
|
14144
|
+
|
|
14145
|
+
<dl>
|
|
14146
|
+
<dd>
|
|
14147
|
+
|
|
14148
|
+
```typescript
|
|
14149
|
+
await client.attackProtection.phoneProviderProtection.patch({
|
|
14150
|
+
type: "exponential",
|
|
14151
|
+
});
|
|
14152
|
+
```
|
|
14153
|
+
|
|
14154
|
+
</dd>
|
|
14155
|
+
</dl>
|
|
14156
|
+
</dd>
|
|
14157
|
+
</dl>
|
|
14158
|
+
|
|
14159
|
+
#### ⚙️ Parameters
|
|
14160
|
+
|
|
14161
|
+
<dl>
|
|
14162
|
+
<dd>
|
|
14163
|
+
|
|
14164
|
+
<dl>
|
|
14165
|
+
<dd>
|
|
14166
|
+
|
|
14167
|
+
**request:** `Management.PatchPhoneProviderProtectionRequestContent`
|
|
14168
|
+
|
|
14169
|
+
</dd>
|
|
14170
|
+
</dl>
|
|
14171
|
+
|
|
14172
|
+
<dl>
|
|
14173
|
+
<dd>
|
|
14174
|
+
|
|
14175
|
+
**requestOptions:** `PhoneProviderProtectionClient.RequestOptions`
|
|
14176
|
+
|
|
14177
|
+
</dd>
|
|
14178
|
+
</dl>
|
|
14179
|
+
</dd>
|
|
14180
|
+
</dl>
|
|
14181
|
+
|
|
14182
|
+
</dd>
|
|
14183
|
+
</dl>
|
|
14184
|
+
</details>
|
|
14185
|
+
|
|
14083
14186
|
## AttackProtection SuspiciousIpThrottling
|
|
14084
14187
|
|
|
14085
14188
|
<details><summary><code>client.attackProtection.suspiciousIpThrottling.<a href="/src/management/api/resources/attackProtection/resources/suspiciousIpThrottling/client/Client.ts">get</a>() -> Management.GetSuspiciousIpThrottlingSettingsResponseContent</code></summary>
|
|
@@ -14841,7 +14944,7 @@ await client.branding.themes.update("themeId", {
|
|
|
14841
14944
|
<dl>
|
|
14842
14945
|
<dd>
|
|
14843
14946
|
|
|
14844
|
-
Retrieve a list of
|
|
14947
|
+
Retrieve a list of [phone providers](https://auth0.com/docs/customize/phone-messages/configure-phone-messaging-providers) details set for a Tenant. A list of fields to include or exclude may also be specified.
|
|
14845
14948
|
|
|
14846
14949
|
</dd>
|
|
14847
14950
|
</dl>
|
|
@@ -14906,8 +15009,8 @@ await client.branding.phone.providers.list({
|
|
|
14906
15009
|
<dl>
|
|
14907
15010
|
<dd>
|
|
14908
15011
|
|
|
14909
|
-
Create a
|
|
14910
|
-
The
|
|
15012
|
+
Create a [phone provider](https://auth0.com/docs/customize/phone-messages/configure-phone-messaging-providers).
|
|
15013
|
+
The `credentials` object requires different properties depending on the phone provider (which is specified using the `name` property).
|
|
14911
15014
|
|
|
14912
15015
|
</dd>
|
|
14913
15016
|
</dl>
|
|
@@ -14975,7 +15078,7 @@ await client.branding.phone.providers.create({
|
|
|
14975
15078
|
<dl>
|
|
14976
15079
|
<dd>
|
|
14977
15080
|
|
|
14978
|
-
Retrieve
|
|
15081
|
+
Retrieve [phone provider](https://auth0.com/docs/customize/phone-messages/configure-phone-messaging-providers) details. A list of fields to include or exclude may also be specified.
|
|
14979
15082
|
|
|
14980
15083
|
</dd>
|
|
14981
15084
|
</dl>
|
|
@@ -15101,8 +15204,8 @@ await client.branding.phone.providers.delete("id");
|
|
|
15101
15204
|
<dl>
|
|
15102
15205
|
<dd>
|
|
15103
15206
|
|
|
15104
|
-
Update a
|
|
15105
|
-
The
|
|
15207
|
+
Update a [phone provider](https://auth0.com/docs/customize/phone-messages/configure-phone-messaging-providers).
|
|
15208
|
+
The `credentials` object requires different properties depending on the phone provider (which is specified using the `name` property).
|
|
15106
15209
|
|
|
15107
15210
|
</dd>
|
|
15108
15211
|
</dl>
|
|
@@ -15679,7 +15782,7 @@ const response = page.response;
|
|
|
15679
15782
|
|
|
15680
15783
|
Get the details of a client credential.
|
|
15681
15784
|
|
|
15682
|
-
|
|
15785
|
+
**Important**: To enable credentials to be used for a client authentication method, set the `client_authentication_methods` property on the client. To enable credentials to be used for JWT-Secured Authorization requests set the `signed_request_object` property on the client.
|
|
15683
15786
|
|
|
15684
15787
|
</dd>
|
|
15685
15788
|
</dl>
|
|
@@ -15744,43 +15847,65 @@ await client.clients.credentials.list("client_id");
|
|
|
15744
15847
|
|
|
15745
15848
|
Create a client credential associated to your application. Credentials can be used to configure Private Key JWT and mTLS authentication methods, as well as for JWT-secured Authorization requests.
|
|
15746
15849
|
|
|
15747
|
-
|
|
15748
|
-
|
|
15749
|
-
|
|
15750
|
-
|
|
15751
|
-
|
|
15752
|
-
|
|
15753
|
-
|
|
15754
|
-
|
|
15755
|
-
"
|
|
15756
|
-
|
|
15757
|
-
|
|
15758
|
-
|
|
15759
|
-
|
|
15760
|
-
|
|
15761
|
-
|
|
15762
|
-
|
|
15763
|
-
|
|
15764
|
-
|
|
15765
|
-
|
|
15766
|
-
|
|
15767
|
-
|
|
15768
|
-
|
|
15769
|
-
|
|
15770
|
-
|
|
15771
|
-
|
|
15772
|
-
|
|
15850
|
+
**Public Key**
|
|
15851
|
+
|
|
15852
|
+
Public Key credentials can be used to set up Private Key JWT client authentication and JWT-secured Authorization requests.
|
|
15853
|
+
|
|
15854
|
+
Sample:
|
|
15855
|
+
|
|
15856
|
+
```json
|
|
15857
|
+
{
|
|
15858
|
+
"credential_type": "public_key",
|
|
15859
|
+
"name": "string",
|
|
15860
|
+
"pem": "string",
|
|
15861
|
+
"alg": "RS256",
|
|
15862
|
+
"parse_expiry_from_cert": false,
|
|
15863
|
+
"expires_at": "2022-12-31T23:59:59Z"
|
|
15864
|
+
}
|
|
15865
|
+
```
|
|
15866
|
+
|
|
15867
|
+
**Certificate (CA-signed & self-signed)**
|
|
15868
|
+
|
|
15869
|
+
Certificate credentials can be used to set up mTLS client authentication. CA-signed certificates can be configured either with a signed certificate or with just the certificate Subject DN.
|
|
15870
|
+
|
|
15871
|
+
CA-signed Certificate Sample (pem):
|
|
15872
|
+
|
|
15873
|
+
```json
|
|
15874
|
+
{
|
|
15875
|
+
"credential_type": "x509_cert",
|
|
15876
|
+
"name": "string",
|
|
15877
|
+
"pem": "string"
|
|
15878
|
+
}
|
|
15879
|
+
```
|
|
15880
|
+
|
|
15881
|
+
CA-signed Certificate Sample (subject_dn):
|
|
15882
|
+
|
|
15883
|
+
```json
|
|
15884
|
+
{
|
|
15885
|
+
"credential_type": "cert_subject_dn",
|
|
15886
|
+
"name": "string",
|
|
15887
|
+
"subject_dn": "string"
|
|
15888
|
+
}
|
|
15889
|
+
```
|
|
15890
|
+
|
|
15891
|
+
Self-signed Certificate Sample:
|
|
15892
|
+
|
|
15893
|
+
```json
|
|
15894
|
+
{
|
|
15895
|
+
"credential_type": "cert_subject_dn",
|
|
15896
|
+
"name": "string",
|
|
15897
|
+
"pem": "string"
|
|
15898
|
+
}
|
|
15899
|
+
```
|
|
15773
15900
|
|
|
15774
15901
|
The credential will be created but not yet enabled for use until you set the corresponding properties in the client:
|
|
15775
15902
|
|
|
15776
|
-
|
|
15777
|
-
|
|
15778
|
-
|
|
15779
|
-
</
|
|
15780
|
-
</dd>
|
|
15781
|
-
</dl>
|
|
15782
|
-
</dd>
|
|
15783
|
-
</dl>
|
|
15903
|
+
- To enable the credential for Private Key JWT or mTLS authentication methods, set the `client_authentication_methods` property on the client. For more information, read [Configure Private Key JWT Authentication](https://auth0.com/docs/get-started/applications/configure-private-key-jwt) and [Configure mTLS Authentication](https://auth0.com/docs/get-started/applications/configure-mtls)
|
|
15904
|
+
- To enable the credential for JWT-secured Authorization requests, set the `signed_request_object`property on the client. For more information, read [Configure JWT-secured Authorization Requests (JAR)](https://auth0.com/docs/get-started/applications/configure-jar)
|
|
15905
|
+
</dd>
|
|
15906
|
+
</dl>
|
|
15907
|
+
</dd>
|
|
15908
|
+
</dl>
|
|
15784
15909
|
|
|
15785
15910
|
#### 🔌 Usage
|
|
15786
15911
|
|
|
@@ -15850,7 +15975,7 @@ await client.clients.credentials.create("client_id", {
|
|
|
15850
15975
|
|
|
15851
15976
|
Get the details of a client credential.
|
|
15852
15977
|
|
|
15853
|
-
|
|
15978
|
+
**Important**: To enable credentials to be used for a client authentication method, set the `client_authentication_methods` property on the client. To enable credentials to be used for JWT-Secured Authorization requests set the `signed_request_object` property on the client.
|
|
15854
15979
|
|
|
15855
15980
|
</dd>
|
|
15856
15981
|
</dl>
|
|
@@ -16073,20 +16198,14 @@ await client.clients.credentials.update("client_id", "credential_id");
|
|
|
16073
16198
|
<dl>
|
|
16074
16199
|
<dd>
|
|
16075
16200
|
|
|
16076
|
-
Retrieve all connections that are enabled for the specified
|
|
16201
|
+
Retrieve all connections that are enabled for the specified [Application](https://www.auth0.com/docs/get-started/applications), using checkpoint pagination. A list of fields to include or exclude for each connection may also be specified.
|
|
16077
16202
|
|
|
16078
|
-
|
|
16079
|
-
|
|
16080
|
-
|
|
16081
|
-
</
|
|
16082
|
-
|
|
16083
|
-
|
|
16084
|
-
</li>
|
|
16085
|
-
</ul>
|
|
16086
|
-
</dd>
|
|
16087
|
-
</dl>
|
|
16088
|
-
</dd>
|
|
16089
|
-
</dl>
|
|
16203
|
+
- This endpoint requires the `read:connections` scope and any one of `read:clients` or `read:client_summary`.
|
|
16204
|
+
- **Note**: The first time you call this endpoint, omit the `from` parameter. If there are more results, a `next` value is included in the response. You can use this for subsequent API calls. When `next` is no longer included in the response, no further results are remaining.
|
|
16205
|
+
</dd>
|
|
16206
|
+
</dl>
|
|
16207
|
+
</dd>
|
|
16208
|
+
</dl>
|
|
16090
16209
|
|
|
16091
16210
|
#### 🔌 Usage
|
|
16092
16211
|
|
|
@@ -17883,7 +18002,7 @@ await client.connections.scimConfiguration.tokens.delete("id", "tokenId");
|
|
|
17883
18002
|
<dl>
|
|
17884
18003
|
<dd>
|
|
17885
18004
|
|
|
17886
|
-
Retrieve details of the
|
|
18005
|
+
Retrieve details of the [email provider configuration](https://auth0.com/docs/customize/email/smtp-email-providers) in your tenant. A list of fields to include or exclude may also be specified.
|
|
17887
18006
|
|
|
17888
18007
|
</dd>
|
|
17889
18008
|
</dl>
|
|
@@ -17949,53 +18068,35 @@ await client.emails.provider.get({
|
|
|
17949
18068
|
<dl>
|
|
17950
18069
|
<dd>
|
|
17951
18070
|
|
|
17952
|
-
Create an
|
|
17953
|
-
requires different properties depending on the email provider (which is specified using the
|
|
18071
|
+
Create an [email provider](https://auth0.com/docs/email/providers). The `credentials` object
|
|
18072
|
+
requires different properties depending on the email provider (which is specified using the `name` property):
|
|
18073
|
+
|
|
18074
|
+
- `mandrill` requires `api_key`
|
|
18075
|
+
- `sendgrid` requires `api_key`
|
|
18076
|
+
- `sparkpost` requires `api_key`. Optionally, set `region` to `eu` to use
|
|
18077
|
+
the SparkPost service hosted in Western Europe; set to `null` to use the SparkPost service hosted in
|
|
18078
|
+
North America. `eu` or `null` are the only valid values for `region`.
|
|
18079
|
+
- `mailgun` requires `api_key` and `domain`. Optionally, set `region` to
|
|
18080
|
+
`eu` to use the Mailgun service hosted in Europe; set to `null` otherwise. `eu` or
|
|
18081
|
+
`null` are the only valid values for `region`.
|
|
18082
|
+
- `ses` requires `accessKeyId`, `secretAccessKey`, and `region`
|
|
18083
|
+
- `smtp` requires `smtp_host`, `smtp_port`, `smtp_user`, and
|
|
18084
|
+
`smtp_pass`
|
|
17954
18085
|
|
|
17955
|
-
|
|
17956
|
-
<li><code>mandrill</code> requires <code>api_key</code></li>
|
|
17957
|
-
<li><code>sendgrid</code> requires <code>api_key</code></li>
|
|
17958
|
-
<li>
|
|
17959
|
-
<code>sparkpost</code> requires <code>api_key</code>. Optionally, set <code>region</code> to <code>eu</code> to use
|
|
17960
|
-
the SparkPost service hosted in Western Europe; set to <code>null</code> to use the SparkPost service hosted in
|
|
17961
|
-
North America. <code>eu</code> or <code>null</code> are the only valid values for <code>region</code>.
|
|
17962
|
-
</li>
|
|
17963
|
-
<li>
|
|
17964
|
-
<code>mailgun</code> requires <code>api_key</code> and <code>domain</code>. Optionally, set <code>region</code> to
|
|
17965
|
-
<code>eu</code> to use the Mailgun service hosted in Europe; set to <code>null</code> otherwise. <code>eu</code> or
|
|
17966
|
-
<code>null</code> are the only valid values for <code>region</code>.
|
|
17967
|
-
</li>
|
|
17968
|
-
<li><code>ses</code> requires <code>accessKeyId</code>, <code>secretAccessKey</code>, and <code>region</code></li>
|
|
17969
|
-
<li>
|
|
17970
|
-
<code>smtp</code> requires <code>smtp_host</code>, <code>smtp_port</code>, <code>smtp_user</code>, and
|
|
17971
|
-
<code>smtp_pass</code>
|
|
17972
|
-
</li>
|
|
17973
|
-
</ul>
|
|
17974
|
-
Depending on the type of provider it is possible to specify <code>settings</code> object with different configuration
|
|
18086
|
+
Depending on the type of provider it is possible to specify `settings` object with different configuration
|
|
17975
18087
|
options, which will be used when sending an email:
|
|
17976
|
-
|
|
17977
|
-
|
|
17978
|
-
|
|
17979
|
-
|
|
17980
|
-
|
|
17981
|
-
|
|
17982
|
-
|
|
17983
|
-
|
|
17984
|
-
|
|
17985
|
-
|
|
17986
|
-
|
|
17987
|
-
|
|
17988
|
-
</ul>
|
|
17989
|
-
</li>
|
|
17990
|
-
<li>
|
|
17991
|
-
for <code>ses</code> provider, <code>settings</code> may contain <code>message</code> object, where you can provide
|
|
17992
|
-
a name of configuration set in <code>configuration_set_name</code> property. Value must be a string.
|
|
17993
|
-
</li>
|
|
17994
|
-
</ul>
|
|
17995
|
-
</dd>
|
|
17996
|
-
</dl>
|
|
17997
|
-
</dd>
|
|
17998
|
-
</dl>
|
|
18088
|
+
|
|
18089
|
+
- `smtp` provider, `settings` may contain `headers` object.
|
|
18090
|
+
- When using AWS SES SMTP host, you may provide a name of configuration set in
|
|
18091
|
+
`X-SES-Configuration-Set` header. Value must be a string.
|
|
18092
|
+
- When using Sparkpost host, you may provide value for
|
|
18093
|
+
`X-MSYS_API` header. Value must be an object.
|
|
18094
|
+
- For `ses` provider, `settings` may contain `message` object, where you can provide
|
|
18095
|
+
a name of configuration set in `configuration_set_name` property. Value must be a string.
|
|
18096
|
+
</dd>
|
|
18097
|
+
</dl>
|
|
18098
|
+
</dd>
|
|
18099
|
+
</dl>
|
|
17999
18100
|
|
|
18000
18101
|
#### 🔌 Usage
|
|
18001
18102
|
|
|
@@ -18113,51 +18214,34 @@ await client.emails.provider.delete();
|
|
|
18113
18214
|
<dl>
|
|
18114
18215
|
<dd>
|
|
18115
18216
|
|
|
18116
|
-
Update an
|
|
18117
|
-
requires different properties depending on the email provider (which is specified using the
|
|
18217
|
+
Update an [email provider](https://auth0.com/docs/email/providers). The `credentials` object
|
|
18218
|
+
requires different properties depending on the email provider (which is specified using the `name` property):
|
|
18118
18219
|
|
|
18119
|
-
|
|
18120
|
-
|
|
18121
|
-
|
|
18122
|
-
|
|
18123
|
-
|
|
18124
|
-
|
|
18125
|
-
|
|
18126
|
-
|
|
18127
|
-
|
|
18128
|
-
|
|
18129
|
-
|
|
18130
|
-
|
|
18131
|
-
|
|
18132
|
-
<li><code>ses</code> requires <code>accessKeyId</code>, <code>secretAccessKey</code>, and <code>region</code></li>
|
|
18133
|
-
<li>
|
|
18134
|
-
<code>smtp</code> requires <code>smtp_host</code>, <code>smtp_port</code>, <code>smtp_user</code>, and
|
|
18135
|
-
<code>smtp_pass</code>
|
|
18136
|
-
</li>
|
|
18137
|
-
</ul>
|
|
18138
|
-
Depending on the type of provider it is possible to specify <code>settings</code> object with different configuration
|
|
18220
|
+
- `mandrill` requires `api_key`
|
|
18221
|
+
- `sendgrid` requires `api_key`
|
|
18222
|
+
- `sparkpost` requires `api_key`. Optionally, set `region` to `eu` to use
|
|
18223
|
+
the SparkPost service hosted in Western Europe; set to `null` to use the SparkPost service hosted in
|
|
18224
|
+
North America. `eu` or `null` are the only valid values for `region`.
|
|
18225
|
+
- `mailgun` requires `api_key` and `domain`. Optionally, set `region` to
|
|
18226
|
+
`eu` to use the Mailgun service hosted in Europe; set to `null` otherwise. `eu` or
|
|
18227
|
+
`null` are the only valid values for `region`.
|
|
18228
|
+
- `ses` requires `accessKeyId`, `secretAccessKey`, and `region`
|
|
18229
|
+
- `smtp` requires `smtp_host`, `smtp_port`, `smtp_user`, and
|
|
18230
|
+
`smtp_pass`
|
|
18231
|
+
|
|
18232
|
+
Depending on the type of provider it is possible to specify `settings` object with different configuration
|
|
18139
18233
|
options, which will be used when sending an email:
|
|
18140
|
-
|
|
18141
|
-
|
|
18142
|
-
|
|
18143
|
-
|
|
18144
|
-
|
|
18145
|
-
|
|
18146
|
-
|
|
18147
|
-
|
|
18148
|
-
|
|
18149
|
-
|
|
18150
|
-
|
|
18151
|
-
</li>
|
|
18152
|
-
</ul>
|
|
18153
|
-
for <code>ses</code> provider, <code>settings</code> may contain <code>message</code> object, where you can provide
|
|
18154
|
-
a name of configuration set in <code>configuration_set_name</code> property. Value must be a string.
|
|
18155
|
-
</li>
|
|
18156
|
-
</ul>
|
|
18157
|
-
</dd>
|
|
18158
|
-
</dl>
|
|
18159
|
-
</dd>
|
|
18160
|
-
</dl>
|
|
18234
|
+
|
|
18235
|
+
- `smtp` provider, `settings` may contain `headers` object. - When using AWS SES SMTP host, you may provide a name of configuration set in
|
|
18236
|
+
`X-SES-Configuration-Set` header. Value must be a string. - When using Sparkpost host, you may provide value for
|
|
18237
|
+
`X-MSYS_API` header. Value must be an object.
|
|
18238
|
+
|
|
18239
|
+
For `ses` provider, `settings` may contain `message` object, where you can provide
|
|
18240
|
+
a name of configuration set in `configuration_set_name` property. Value must be a string.
|
|
18241
|
+
</dd>
|
|
18242
|
+
</dl>
|
|
18243
|
+
</dd>
|
|
18244
|
+
</dl>
|
|
18161
18245
|
|
|
18162
18246
|
#### 🔌 Usage
|
|
18163
18247
|
|
|
@@ -19023,7 +19107,7 @@ const response = page.response;
|
|
|
19023
19107
|
<dl>
|
|
19024
19108
|
<dd>
|
|
19025
19109
|
|
|
19026
|
-
Lists the
|
|
19110
|
+
Lists the [roles](https://auth0.com/docs/manage-users/access-control/rbac) assigned to a group.
|
|
19027
19111
|
|
|
19028
19112
|
</dd>
|
|
19029
19113
|
</dl>
|
|
@@ -19112,7 +19196,7 @@ const response = page.response;
|
|
|
19112
19196
|
<dl>
|
|
19113
19197
|
<dd>
|
|
19114
19198
|
|
|
19115
|
-
Assign one or more
|
|
19199
|
+
Assign one or more [roles](https://auth0.com/docs/manage-users/access-control/rbac) to a specified group.
|
|
19116
19200
|
|
|
19117
19201
|
</dd>
|
|
19118
19202
|
</dl>
|
|
@@ -19185,7 +19269,7 @@ await client.groups.roles.create("id", {
|
|
|
19185
19269
|
<dl>
|
|
19186
19270
|
<dd>
|
|
19187
19271
|
|
|
19188
|
-
Unassign one or more
|
|
19272
|
+
Unassign one or more [roles](https://auth0.com/docs/manage-users/access-control/rbac) from a specified group.
|
|
19189
19273
|
|
|
19190
19274
|
</dd>
|
|
19191
19275
|
</dl>
|