8000 Merge pull request #42 from Hacker0x01/api-token · pandas-devs/docs.hackerone.com@c757bac · GitHub
[go: up one dir, main page]
Skip to content

Commit c757bac

Browse files
stacyspivastacyspiva
authored
Merge pull request Hacker0x01#42 from Hacker0x01/api-token
api tokens
2 parents 1e77a38 + d0c9511 commit c757bac

File tree

2 files changed

+36
-0
lines changed

2 files changed

+36
-0
lines changed

‎docs/programs/api-tokens.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
title: "API Tokens"
3+
path: "/programs/api-tokens.html"
4+
id: "programs/api-tokens"
5+
---
6+
7+
Your program’s administrative users can generate and manage API tokens to experiment with or use the HackerOne API. The API token identifier and value are used as the username and password for HTTP Basic authentication.
8+
9+
To generate an API token:
10+
1. Go to <b>Settings > Program > Automation > API</b>.
11+
![api-token-1](./images/api-token-1.png)
12+
13+
2. Click <b>Create API Token</b>.
14+
![api-token-2](./images/api-token-2.png)
15+
16+
3. Enter an identifier for the new API token.
17+
![api-token-3](./images/api-token-3.png)
18+
19+
4. Store the generated API token.
20+
5. Click <b>I have stored the API Token</b>.
21+
![api-token-4](./images/api-token-4.png)
22+
23+
You’ll get a confirmation email stating that you’ve created a new API token. You can manage the groups that have access to the API tokens and revoke the token as well.
24+
25+
To learn more about the HackerOne API check out our [API docs](https://api.hackerone.com/docs/v1).
26+
27+
### Managing Groups
28+
To manage which groups have access to the API tokens:
29+
1. Click <b>Manage groups</b> on the API settings page for the identifier you want to manage groups for.
30+
![api-token-5](./images/api-token-5.png)
31+
32+
2. Select which groups you want to give permissions to. When a group isn’t selected, they only have read-only permissions.
33+
3. Click <b>Apply changes</b>.
34+
![api-token-6](./images/api-token-6.png)

‎src/pages/programs/programs-nav.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,8 @@
127127
path: /programs/supported-integrations.html
128128
- title: Embedded Submission Form
129129
path: /programs/embedded-submissions-form.html
130+
- title: API Tokens
131+
path: /programs/api-tokens.html
130132
- title: Assembla
131133
path: /programs/assembla-integration.html
132134
- title: Bugzilla

0 commit comments

Comments
 (0)
0