Skip to content

Commit b2811e2

Browse files
authored
Merge pull request #145 from mintlify-onboarding/auth-code-group
Adds AuthCodeGroup, footer on home and other design changes
2 parents 31f205d + fa361e0 commit b2811e2

File tree

548 files changed

+55852
-49049
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

548 files changed

+55852
-49049
lines changed

main/docs.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
},
99
"seo": {
1010
"metatags": {
11-
"canonical": "https://auth0.com/docs"
11+
"canonical": "https://auth0.com"
1212
}
1313
},
1414
"banner": {

main/docs/authenticate/database-connections/password-change.mdx

Lines changed: 98 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ title: Change Users' Passwords
1212
---
1313
import {AuthCodeBlock} from "/snippets/AuthCodeBlock.jsx";
1414

15+
import {AuthCodeGroup} from "/snippets/AuthCodeGroup.jsx";
16+
1517
<Card title="Overview">
1618

1719
Key Concepts
@@ -59,16 +61,22 @@ Go to [Auth0 Dashboard > Applications > Applications](https://manage.auth0.com/#
5961

6062
If your connection is a custom database, check to see if the user exists in the database before you invoke the Authentication API for `changePassword`.
6163

62-
export const codeExample1 = `curl --request POST \
64+
<AuthCodeGroup>
65+
```bash cURL
66+
curl --request POST \
6367
--url 'https://{yourDomain}/dbconnections/change_password' \
6468
--header 'content-type: application/json' \
65-
--data '{"client_id": "{yourClientId}","email": "","connection": "Username-Password-Authentication"}'`;
66-
export const codeExample2 = `var client = new RestClient("https://{yourDomain}/dbconnections/change_password");
69+
--data '{"client_id": "{yourClientId}","email": "","connection": "Username-Password-Authentication"}'
70+
```
71+
```csharp C#
72+
var client = new RestClient("https://{yourDomain}/dbconnections/change_password");
6773
var request = new RestRequest(Method.POST);
6874
request.AddHeader("content-type", "application/json");
69-
request.AddParameter("application/json", "{\"client_id\": \"{yourClientId}\",\"email\": \"\",\"connection\": \"Username-Password-Authentication\"}", ParameterType.RequestBody);
70-
IRestResponse response = client.Execute(request);`;
71-
export const codeExample3 = `package main
75+
request.AddParameter("application/json", "{"client_id": "{yourClientId}","email": "","connection": "Username-Password-Authentication"}", ParameterType.RequestBody);
76+
IRestResponse response = client.Execute(request);
77+
```
78+
```go Go
79+
package main
7280

7381
import (
7482
"fmt"
@@ -81,7 +89,7 @@ func main() {
8189

8290
url := "https://{yourDomain}/dbconnections/change_password"
8391

84-
payload := strings.NewReader("{\"client_id\": \"{yourClientId}\",\"email\": \"\",\"connection\": \"Username-Password-Authentication\"}")
92+
payload := strings.NewReader("{"client_id": "{yourClientId}","email": "","connection": "Username-Password-Authentication"}")
8593

8694
req, _ := http.NewRequest("POST", url, payload)
8795

@@ -95,12 +103,16 @@ func main() {
95103
fmt.Println(res)
96104
fmt.Println(string(body))
97105

98-
}`;
99-
export const codeExample4 = `HttpResponse<String> response = Unirest.post("https://{yourDomain}/dbconnections/change_password")
106+
}
107+
```
108+
```java Java
109+
HttpResponse<String> response = Unirest.post("https://{yourDomain}/dbconnections/change_password")
100110
.header("content-type", "application/json")
101-
.body("{\"client_id\": \"{yourClientId}\",\"email\": \"\",\"connection\": \"Username-Password-Authentication\"}")
102-
.asString();`;
103-
export const codeExample5 = `var axios = require("axios").default;
111+
.body("{"client_id": "{yourClientId}","email": "","connection": "Username-Password-Authentication"}")
112+
.asString();
113+
```
114+
```javascript Node.JS
115+
var axios = require("axios").default;
104116

105117
var options = {
106118
method: 'POST',
@@ -117,8 +129,10 @@ axios.request(options).then(function (response) {
117129
console.log(response.data);
118130
}).catch(function (error) {
119131
console.error(error);
120-
});`;
121-
export const codeExample6 = `#import <Foundation/Foundation.h>
132+
});
133+
```
134+
```obj-c Obj-C
135+
#import <Foundation/Foundation.h>
122136

123137
NSDictionary *headers = @{ @"content-type": @"application/json" };
124138
NSDictionary *parameters = @{ @"client_id": @"{yourClientId}",
@@ -144,8 +158,10 @@ NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
144158
NSLog(@"%@", httpResponse);
145159
}
146160
}];
147-
[dataTask resume];`;
148-
export const codeExample7 = `$curl = curl_init();
161+
[dataTask resume];
162+
```
163+
```php PHP
164+
$curl = curl_init();
149165
150166
curl_setopt_array($curl, [
151167
CURLOPT_URL => "https://{yourDomain}/dbconnections/change_password",
@@ -155,7 +171,7 @@ curl_setopt_array($curl, [
155171
CURLOPT_TIMEOUT => 30,
156172
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
157173
CURLOPT_CUSTOMREQUEST => "POST",
158-
CURLOPT_POSTFIELDS => "{\"client_id\": \"{yourClientId}\",\"email\": \"\",\"connection\": \"Username-Password-Authentication\"}",
174+
CURLOPT_POSTFIELDS => "{"client_id": "{yourClientId}","email": "","connection": "Username-Password-Authentication"}",
159175
CURLOPT_HTTPHEADER => [
160176
"content-type: application/json"
161177
],
@@ -170,12 +186,14 @@ if ($err) {
170186
echo "cURL Error #:" . $err;
171187
} else {
172188
echo $response;
173-
}`;
174-
export const codeExample8 = `import http.client
189+
}
190+
```
191+
```python Python
192+
import http.client
175193

176194
conn = http.client.HTTPSConnection("")
177195

178-
payload = "{\"client_id\": \"{yourClientId}\",\"email\": \"\",\"connection\": \"Username-Password-Authentication\"}"
196+
payload = "{"client_id": "{yourClientId}","email": "","connection": "Username-Password-Authentication"}"
179197

180198
headers = { 'content-type': "application/json" }
181199

@@ -184,8 +202,10 @@ conn.request("POST", "/{yourDomain}/dbconnections/change_password", payload, hea
184202
res = conn.getresponse()
185203
data = res.read()
186204

187-
print(data.decode("utf-8"))`;
188-
export const codeExample9 = `require 'uri'
205+
print(data.decode("utf-8"))
206+
```
207+
```ruby Ruby
208+
require 'uri'
189209
require 'net/http'
190210
require 'openssl'
191211

@@ -197,11 +217,13 @@ http.verify_mode = OpenSSL::SSL::VERIFY_NONE
197217

198218
request = Net::HTTP::Post.new(url)
199219
request["content-type"] = 'application/json'
200-
request.body = "{\"client_id\": \"{yourClientId}\",\"email\": \"\",\"connection\": \"Username-Password-Authentication\"}"
220+
request.body = "{"client_id": "{yourClientId}","email": "","connection": "Username-Password-Authentication"}"
201221

202222
response = http.request(request)
203-
puts response.read_body`;
204-
export const codeExample10 = `import Foundation
223+
puts response.read_body
224+
```
225+
```swift Swift
226+
import Foundation
205227

206228
let headers = ["content-type": "application/json"]
207229
let parameters = [
@@ -229,20 +251,9 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
229251
}
230252
})
231253

232-
dataTask.resume()`;
233-
234-
<CodeGroup>
235-
<AuthCodeBlock children={codeExample1} language="bash" filename="cURL" />
236-
<AuthCodeBlock children={codeExample2} language="csharp" filename="C#" />
237-
<AuthCodeBlock children={codeExample3} language="go" filename="Go" />
238-
<AuthCodeBlock children={codeExample4} language="java" filename="Java" />
239-
<AuthCodeBlock children={codeExample5} language="javascript" filename="Node.JS" />
240-
<AuthCodeBlock children={codeExample6} language="obj-c" filename="Obj-C" />
241-
<AuthCodeBlock children={codeExample7} language="php" filename="PHP" />
242-
<AuthCodeBlock children={codeExample8} language="python" filename="Python" />
243-
<AuthCodeBlock children={codeExample9} language="ruby" filename="Ruby" />
244-
<AuthCodeBlock children={codeExample10} language="swift" filename="Swift" />
245-
</CodeGroup>
254+
dataTask.resume()
255+
```
256+
</AuthCodeGroup>
246257

247258
### Password reset email
248259

@@ -291,18 +302,24 @@ If you use Management API to set or update a user's password via the [Update a U
291302

292303
</Callout>
293304

294-
export const codeExample11 = `curl --request PATCH \
305+
<AuthCodeGroup>
306+
```bash cURL
307+
curl --request PATCH \
295308
--url 'https://{yourDomain}/api/v2/users/%7BuserId%7D' \
296309
--header 'authorization: Bearer {yourMgmtApiAccessToken}' \
297310
--header 'content-type: application/json' \
298-
--data '{"password": "newPassword","connection": "connectionName"}'`;
299-
export const codeExample12 = `var client = new RestClient("https://{yourDomain}/api/v2/users/%7BuserId%7D");
311+
--data '{"password": "newPassword","connection": "connectionName"}'
312+
```
313+
```csharp C#
314+
var client = new RestClient("https://{yourDomain}/api/v2/users/%7BuserId%7D");
300315
var request = new RestRequest(Method.PATCH);
301316
request.AddHeader("content-type", "application/json");
302317
request.AddHeader("authorization", "Bearer {yourMgmtApiAccessToken}");
303-
request.AddParameter("application/json", "{\"password\": \"newPassword\",\"connection\": \"connectionName\"}", ParameterType.RequestBody);
304-
IRestResponse response = client.Execute(request);`;
305-
export const codeExample13 = `package main
318+
request.AddParameter("application/json", "{"password": "newPassword","connection": "connectionName"}", ParameterType.RequestBody);
319+
IRestResponse response = client.Execute(request);
320+
```
321+
```go Go
322+
package main
306323

307324
import (
308325
"fmt"
@@ -315,7 +332,7 @@ func main() {
315332

316333
url := "https://{yourDomain}/api/v2/users/%7BuserId%7D"
317334

318-
payload := strings.NewReader("{\"password\": \"newPassword\",\"connection\": \"connectionName\"}")
335+
payload := strings.NewReader("{"password": "newPassword","connection": "connectionName"}")
319336

320337
req, _ := http.NewRequest("PATCH", url, payload)
321338

@@ -330,13 +347,17 @@ func main() {
330347
fmt.Println(res)
331348
fmt.Println(string(body))
332349

333-
}`;
334-
export const codeExample14 = `HttpResponse<String> response = Unirest.patch("https://{yourDomain}/api/v2/users/%7BuserId%7D")
350+
}
351+
```
352+
```java Java
353+
HttpResponse<String> response = Unirest.patch("https://{yourDomain}/api/v2/users/%7BuserId%7D")
335354
.header("content-type", "application/json")
336355
.header("authorization", "Bearer {yourMgmtApiAccessToken}")
337-
.body("{\"password\": \"newPassword\",\"connection\": \"connectionName\"}")
338-
.asString();`;
339-
export const codeExample15 = `var axios = require("axios").default;
356+
.body("{"password": "newPassword","connection": "connectionName"}")
357+
.asString();
358+
```
359+
```javascript Node.JS
360+
var axios = require("axios").default;
340361

341362
var options = {
342363
method: 'PATCH',
@@ -352,8 +373,10 @@ axios.request(options).then(function (response) {
352373
console.log(response.data);
353374
}).catch(function (error) {
354375
console.error(error);
355-
});`;
356-
export const codeExample16 = `#import <Foundation/Foundation.h>
376+
});
377+
```
378+
```obj-c Obj-C
379+
#import <Foundation/Foundation.h>
357380

358381
NSDictionary *headers = @{ @"content-type": @"application/json",
359382
@"authorization": @"Bearer {yourMgmtApiAccessToken}" };
@@ -379,8 +402,10 @@ NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
379402
NSLog(@"%@", httpResponse);
380403
}
381404
}];
382-
[dataTask resume];`;
383-
export const codeExample17 = `$curl = curl_init();
405+
[dataTask resume];
406+
```
407+
```php PHP
408+
$curl = curl_init();
384409
385410
curl_setopt_array($curl, [
386411
CURLOPT_URL => "https://{yourDomain}/api/v2/users/%7BuserId%7D",
@@ -390,7 +415,7 @@ curl_setopt_array($curl, [
390415
CURLOPT_TIMEOUT => 30,
391416
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
392417
CURLOPT_CUSTOMREQUEST => "PATCH",
393-
CURLOPT_POSTFIELDS => "{\"password\": \"newPassword\",\"connection\": \"connectionName\"}",
418+
CURLOPT_POSTFIELDS => "{"password": "newPassword","connection": "connectionName"}",
394419
CURLOPT_HTTPHEADER => [
395420
"authorization: Bearer {yourMgmtApiAccessToken}",
396421
"content-type: application/json"
@@ -406,12 +431,14 @@ if ($err) {
406431
echo "cURL Error #:" . $err;
407432
} else {
408433
echo $response;
409-
}`;
410-
export const codeExample18 = `import http.client
434+
}
435+
```
436+
```python Python
437+
import http.client
411438

412439
conn = http.client.HTTPSConnection("")
413440

414-
payload = "{\"password\": \"newPassword\",\"connection\": \"connectionName\"}"
441+
payload = "{"password": "newPassword","connection": "connectionName"}"
415442

416443
headers = {
417444
'content-type': "application/json",
@@ -423,8 +450,10 @@ conn.request("PATCH", "/{yourDomain}/api/v2/users/%7BuserId%7D", payload, header
423450
res = conn.getresponse()
424451
data = res.read()
425452

426-
print(data.decode("utf-8"))`;
427-
export const codeExample19 = `require 'uri'
453+
print(data.decode("utf-8"))
454+
```
455+
```ruby Ruby
456+
require 'uri'
428457
require 'net/http'
429458
require 'openssl'
430459

@@ -437,11 +466,13 @@ http.verify_mode = OpenSSL::SSL::VERIFY_NONE
437466
request = Net::HTTP::Patch.new(url)
438467
request["content-type"] = 'application/json'
439468
request["authorization"] = 'Bearer {yourMgmtApiAccessToken}'
440-
request.body = "{\"password\": \"newPassword\",\"connection\": \"connectionName\"}"
469+
request.body = "{"password": "newPassword","connection": "connectionName"}"
441470

442471
response = http.request(request)
443-
puts response.read_body`;
444-
export const codeExample20 = `import Foundation
472+
puts response.read_body
473+
```
474+
```swift Swift
475+
import Foundation
445476

446477
let headers = [
447478
"content-type": "application/json",
@@ -471,20 +502,9 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
471502
}
472503
})
473504

474-
dataTask.resume()`;
475-
476-
<CodeGroup>
477-
<AuthCodeBlock children={codeExample11} language="bash" filename="cURL" />
478-
<AuthCodeBlock children={codeExample12} language="csharp" filename="C#" />
479-
<AuthCodeBlock children={codeExample13} language="go" filename="Go" />
480-
<AuthCodeBlock children={codeExample14} language="java" filename="Java" />
481-
<AuthCodeBlock children={codeExample15} language="javascript" filename="Node.JS" />
482-
<AuthCodeBlock children={codeExample16} language="obj-c" filename="Obj-C" />
483-
<AuthCodeBlock children={codeExample17} language="php" filename="PHP" />
484-
<AuthCodeBlock children={codeExample18} language="python" filename="Python" />
485-
<AuthCodeBlock children={codeExample19} language="ruby" filename="Ruby" />
486-
<AuthCodeBlock children={codeExample20} language="swift" filename="Swift" />
487-
</CodeGroup>
505+
dataTask.resume()
506+
```
507+
</AuthCodeGroup>
488508

489509
### Manually set users' passwords using the Auth0 Dashboard
490510

0 commit comments

Comments
 (0)