Skip to content

Commit 842209f

Browse files
authored
[FMEPRD-293] FME RBAC guide: SA permissions (#11639)
* FME RBAC guide: Adjust table formatting for consistency (font weight matching following table) * FME RBAC guide: Remove 'and assign roles' where role is not assigned * FME RBAC guide: Add 'Grant Fewer Permissions to Service Accounts' tip box
1 parent ca0d9d1 commit 842209f

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

docs/feature-management-experimentation/split-to-harness/administering-migrated-account.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ When your account was migrated to Harness, the migration script created new Harn
169169

170170
#### Role bindings at the account and organization levels
171171

172-
| Legacy Split setting | Harness user group | Harness scope <br /> <span style={{fontWeight: 100}}>where the user group is created and managed</span> | Role binding <br /> <span style={{fontWeight: 100}}>Harness role + Harness resource group</span> |
172+
| Legacy Split setting | Harness user group | Harness scope <br /> <span style={{fontWeight: 300}}>where the user group is created and managed</span> | Role binding <br /> <span style={{fontWeight: 300}}>Harness role + Harness resource group</span> |
173173
|---|---|---|---|
174174
| Administrators <br /> <span style={{fontFamily: 'Courier New'}}>Legacy Split group</span> | All FME Admins | Harness account | <span style={{fontFamily: 'Courier New'}}>For a new Harness account:</span> <br /> Account Admin + All Resources Including Child Scopes <br /><br /> Organization Viewer + All Organization Level Resources <br /><br /> <span style={{fontFamily: 'Courier New'}}>For a pre-existing Harness account:</span> <br /> Organization Admin + All Organization Level Resources |
175175
| Editors <br /> <span style={{fontFamily: 'Courier New'}}>Legacy Split role</span> | All FME Editors | Harness account | Organization Viewer + All Organization Level Resources |
@@ -586,13 +586,21 @@ To create an Admin API key scoped to all projects in your Harness account:
586586
If you prefer, you can instead create the service account at the Harness organization level. Steps 1 and 4 would be done at the organization level, and Step 2 would be omitted. The **Organization Admin** role for **All Organization Level Resources** is required for the Admin API key to be granted permission to list Harness projects and Harness elements attached to projects.
587587
:::
588588

589+
:::tip Granting fewer permissions to service accounts
590+
While this guide recommends assigning the **Account Admin**, **Organization Admin**, and **Project Admin** roles to the service account, it is possible that an integration (authenticated by your API key token) does not require the full breadth of admin permissions.
591+
592+
Depending on what operations the integration is performing, you can assign roles with fewer permissions or (on the Enterprise plan) you can create custom roles and assign them to the service account.
593+
594+
For example, you may choose to omit adding permissions for modules other than FME, while enabling most of the permissions listed under **Administrative Functions**. It is very important to follow through with ___complete coverage testing___ (to ensure permissions are sufficient for all integration functionality).
595+
:::
596+
589597
#### Project scope
590598

591599
This section provides steps to create a service account and role bindings for an Admin API key scoped to specific projects in your Harness account. You can follow these steps if you don’t have a service account created during migration or prefer not to use it.
592600

593601
To create an Admin API key scoped to a specific project in your Harness account:
594602

595-
1. At the account level, create the service account and assign roles:
603+
1. At the account level, create the service account:
596604

597605
1. In the left navigation panel, click **Account Settings**.
598606
1. Click the **Access Control** button at the top of the page.

0 commit comments

Comments
 (0)