Skip to content

[Service Now ] Amend token instructions for clarity #462

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 6, 2025
Merged

[Service Now ] Amend token instructions for clarity #462

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e35bedd
Amend token instructions for clarity
halie-kastl Jun 3, 2025
4a5d363
consolidate info, remove repeat
halie-kastl Jun 3, 2025
962fb43
Apply suggestions from code review
rkoron007 Jun 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 3 additions & 9 deletions ...on/docs/cloud-docs/integrations/service-now/service-catalog-terraform/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -110,17 +110,12 @@ Terraform.
**Save the organization name for later.**
2. [Create a team](/terraform/cloud-docs/users-teams-organizations/teams) for that
organization called "ServiceNow", and ensure that it has [permission to
manage
workspaces](/terraform/cloud-docs/users-teams-organizations/permissions#manage-all-workspaces).
manage workspaces](/terraform/cloud-docs/users-teams-organizations/permissions#manage-all-workspaces).
You do not need to add any users to this team.
[permissions-citation]: #intentionally-unused---keep-for-maintainers
3. On the "ServiceNow" team's settings page, generate a [team API
token](/terraform/cloud-docs/users-teams-organizations/api-tokens#team-api-tokens).
token](/terraform/cloud-docs/users-teams-organizations/api-tokens#team-api-tokens). HCP Terraform now supports fine-grained permissions for team tokens at the project level. You can assign teams and their associated tokens permission levels on specific projects. To learn more about the different permissions necessary to provision resources, refer to [Permissions](/terraform/cloud-docs/users-teams-organizations/permissions#project-permissions).
**Save the team API token for later.**
4. After [generating a team token](/terraform/cloud-docs/users-teams-organizations/api-tokens#team-api-tokens) in HCP Terraform, you can add that token to your ServiceNow context by doing the following:
1. Navigate to **Terraform Configs** in ServiceNow
2. Select **New** and add your token.
3. Use your HCP Terraform team name as your **Org name**.
5. If you are using the [VCS flow](/terraform/cloud-docs/integrations/service-now/service-catalog-terraform/service-catalog-config#vcs-configuration):
1. Ensure your Terraform organization is [connected to a VCS provider](/terraform/cloud-docs/vcs). Repositories that are connectable to HCP Terraform workspaces can also be used as workspace templates in the ServiceNow integration.
2. On your organization's VCS provider settings page (**Settings** > **VCS Providers**), find the OAuth Token ID for the VCS provider(s) that you intend to use with the ServiceNow integration. HCP Terraform uses the OAuth token ID to identify and authorize the VCS provider. **Save the OAuth token ID for later.**
Expand Down Expand Up @@ -224,8 +219,7 @@ update request items.
### Team Tokens

Team-scoped tokens can help you manage a team's access to things in HCP Terraform, but team tokens are limited within the ServiceNow context. We recommend only using one API team token, regardless of the number of teams accessing ServiceNow.

You can assign teams and their associated tokens permission levels on specific projects. To learn more about the different permissions necessary to provision resources, refer to [Permissions](/terraform/cloud-docs/users-teams-organizations/permissions#project-permissions). To learn more about API tokens, refer to [Team tokens](https://developer.hashicorp.com/terraform/cloud-docs/users-teams-organizations/api-tokens#team-api-tokens).
To learn more about API tokens, refer to [Team tokens](/terraform/cloud-docs/users-teams-organizations/api-tokens#team-api-tokens).

### ServiceNow Developer Reference

Expand Down
Loading