From be837a95f3b42253ea934d6aaf5ee563d3fa4597 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc-Aur=C3=A8le=20Brothier?= Date: Thu, 28 Nov 2024 16:17:45 +0100 Subject: [PATCH 1/3] chore: add note section on the token for organization member management --- docs/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/index.md b/docs/index.md index 8951f58d..b1a5f031 100644 --- a/docs/index.md +++ b/docs/index.md @@ -28,6 +28,8 @@ It's best practice not to store the authentication token in plain text. As an al provider "sentry" {} ``` +~> **NOTE:** Integration tokens are tied to the organization, not a specific user. Meaning, they cannot be used to invite/delete users, because the scopes do not include permissions at this high of a level. A personal auth token tied to your user role will be able to perform these specific actions if your user is a Manager or Owner is needed for Organization members. + ### Self-hosted Sentry If you are self-hosting Sentry, you can set the base URL here. The URL format must be in the format `https://[hostname]/api/`. From 09c756b6f752c090b87a9555351e2de7d06089f9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc-Aur=C3=A8le=20Brothier?= Date: Thu, 28 Nov 2024 16:23:59 +0100 Subject: [PATCH 2/3] typo --- docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index b1a5f031..c1408f9e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -28,7 +28,7 @@ It's best practice not to store the authentication token in plain text. As an al provider "sentry" {} ``` -~> **NOTE:** Integration tokens are tied to the organization, not a specific user. Meaning, they cannot be used to invite/delete users, because the scopes do not include permissions at this high of a level. A personal auth token tied to your user role will be able to perform these specific actions if your user is a Manager or Owner is needed for Organization members. +~> **NOTE:** Integration tokens are tied to the organization, not a specific user. Meaning, they cannot be used to invite/delete users, because the scopes do not include permissions at this high of a level. A personal auth token tied to your user role will be able to perform Organization's members' actions if your user is a Manager or Owner. ### Self-hosted Sentry From 027398b76ab13ea08f427bab430805cb94e8008f Mon Sep 17 00:00:00 2001 From: Jian Yuan Lee Date: Sun, 1 Dec 2024 09:52:56 +0000 Subject: [PATCH 3/3] fix: docs --- docs/index.md | 5 ++++- templates/index.md.tmpl | 5 +++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index c1408f9e..809f7e71 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,4 +1,7 @@ --- +# Generated from templates/index.md.tmpl +# DO NOT EDIT DIRECTLY + page_title: "Official Sentry Terraform Provider" description: |- Set up Sentry Team, Projects, Alerts, and more. This provider is maintained with [Sentry.io](https://sentry.io)'s sponsorship. Please add any bug reports/feature requests in the GitHub repo. @@ -28,7 +31,7 @@ It's best practice not to store the authentication token in plain text. As an al provider "sentry" {} ``` -~> **NOTE:** Integration tokens are tied to the organization, not a specific user. Meaning, they cannot be used to invite/delete users, because the scopes do not include permissions at this high of a level. A personal auth token tied to your user role will be able to perform Organization's members' actions if your user is a Manager or Owner. +**NOTE:** Integration tokens are tied to the organization, not to a specific user. This means they cannot be used to invite or delete users, as their scopes do not include permissions at such a high level. A personal authentication token tied to your user role can perform organization member-related actions if your user role is set to Manager or Owner. ### Self-hosted Sentry diff --git a/templates/index.md.tmpl b/templates/index.md.tmpl index 4984e75c..7a5ab96f 100644 --- a/templates/index.md.tmpl +++ b/templates/index.md.tmpl @@ -1,4 +1,7 @@ --- +# Generated from templates/index.md.tmpl +# DO NOT EDIT DIRECTLY + page_title: "Official Sentry Terraform Provider" description: |- Set up Sentry Team, Projects, Alerts, and more. This provider is maintained with [Sentry.io](https://sentry.io)'s sponsorship. Please add any bug reports/feature requests in the GitHub repo. @@ -28,6 +31,8 @@ It's best practice not to store the authentication token in plain text. As an al provider "sentry" {} ``` +**NOTE:** Integration tokens are tied to the organization, not to a specific user. This means they cannot be used to invite or delete users, as their scopes do not include permissions at such a high level. A personal authentication token tied to your user role can perform organization member-related actions if your user role is set to Manager or Owner. + ### Self-hosted Sentry If you are self-hosting Sentry, you can set the base URL here. The URL format must be in the format `https://[hostname]/api/`.