|
6 | 6 | - [Specify scope](#specify-scope)
|
7 | 7 | - [Specify Connection scope](#specify-connection-scope)
|
8 | 8 | - [Specify Parameter](#specify-parameter)
|
| 9 | + - [Specify a Custom Authorize URL](#specify-a-custom-authorize-url) |
9 | 10 | - [Customize the Custom Tabs UI](#customize-the-custom-tabs-ui)
|
10 | 11 | - [Changing the Return To URL scheme](#changing-the-return-to-url-scheme)
|
| 12 | + - [Specify a Custom Logout URL](#specify-a-custom-logout-url) |
11 | 13 | - [Trusted Web Activity](#trusted-web-activity)
|
12 | 14 | - [Authentication API](#authentication-api)
|
13 | 15 | - [Login with database connection](#login-with-database-connection)
|
@@ -95,6 +97,30 @@ WebAuthProvider.login(account)
|
95 | 97 | .start(this, callback)
|
96 | 98 | ```
|
97 | 99 |
|
| 100 | +## Specify a Custom Authorize URL |
| 101 | + |
| 102 | +In scenarios where you need to use a specific authorize endpoint different from the one derived from your Auth0 domain (e.g., for custom domains, specific tenant configurations), you can provide a full custom URL to the `/authorize` endpoint. |
| 103 | + |
| 104 | +```kotlin |
| 105 | +WebAuthProvider |
| 106 | +.login(account) |
| 107 | +.withAuthorizeUrl("https://YOUR_CUSTOM_TENANT_OR_AUTH_DOMAIN/authorize") |
| 108 | +.start(this, callback) |
| 109 | +``` |
| 110 | + |
| 111 | +<details> |
| 112 | + <summary>Using Java</summary> |
| 113 | + |
| 114 | +```java |
| 115 | +WebAuthProvider |
| 116 | +.login(account) |
| 117 | +.withAuthorizeUrl("https://YOUR_CUSTOM_TENANT_OR_AUTH_DOMAIN/authorize") |
| 118 | +.start(this, callback); |
| 119 | +``` |
| 120 | +</details> |
| 121 | + |
| 122 | +The URL provided to `.withAuthorizeUrl()` must be a complete and valid HTTPS URL for an OAuth 2.0 authorize endpoint. The SDK will append standard OAuth parameters to this custom base URL. |
| 123 | + |
98 | 124 | ## Customize the Custom Tabs UI
|
99 | 125 |
|
100 | 126 | If the device where the app is running has a Custom Tabs compatible Browser, a Custom Tab will be preferred for the logout flow. You can customize the Page Title visibility, the Toolbar color, and the supported Browser applications by using the `CustomTabsOptions` class.
|
@@ -134,6 +160,29 @@ WebAuthProvider.logout(account)
|
134 | 160 | .start(this, logoutCallback)
|
135 | 161 | ```
|
136 | 162 |
|
| 163 | +## Specify a Custom Logout URL |
| 164 | + |
| 165 | +Similar to the authorize URL, you can specify a custom logout endpoint if your setup requires it (e.g., using custom domains or for specific logout behaviors configured in your Auth0 tenant). |
| 166 | + |
| 167 | +```kotlin |
| 168 | +WebAuthProvider |
| 169 | +.logout(account) |
| 170 | +.withLogoutUrl("https://YOUR_CUSTOM_TENANT_OR_AUTH_DOMAIN/v2/logout") |
| 171 | +.start(this, logoutCallback) |
| 172 | +``` |
| 173 | +<details> |
| 174 | + <summary>Using Java</summary> |
| 175 | + |
| 176 | +```java |
| 177 | +WebAuthProvider |
| 178 | +.logout(account) |
| 179 | +.withLogoutUrl("https://YOUR_CUSTOM_TENANT_OR_AUTH_DOMAIN/v2/logout") |
| 180 | +.start(this, logoutCallback); |
| 181 | +``` |
| 182 | +</details> |
| 183 | + |
| 184 | +The URL provided to `.withLogoutUrl()` must be a complete and valid HTTPS URL for logout endpoint. The SDK will append standard logout parameters to this custom base URL. |
| 185 | + |
137 | 186 | ## Trusted Web Activity
|
138 | 187 |
|
139 | 188 | Trusted Web Activity is a feature provided by some browsers to provide a native look and feel to the custom tabs.
|
@@ -1515,4 +1564,4 @@ The rules should be applied automatically if your application is using `minifyEn
|
1515 | 1564 | By default you should at least use the following files:
|
1516 | 1565 | * `proguard-okio.pro`
|
1517 | 1566 | * `proguard-gson.pro`
|
1518 |
| -* `proguard-jetpack.pro` |
| 1567 | +* `proguard-jetpack.pro` |
0 commit comments