Skip to content

Commit 25fd017

Browse files
committed
Update doc about Create Approval Permission
1 parent caf306c commit 25fd017

File tree

3 files changed

+17
-7
lines changed

3 files changed

+17
-7
lines changed

en/developer-docs/docs/administer/configure-approvals-for-choreo-workflows.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,16 @@ Choreo allows you to configure approval processes for specific workflows within
44

55
Choreo currently allows you to configure approvals for environment promotion and API subscription workflows.
66

7-
Configuring approvals for environment promotion allows authorized users to control components being promoted to a critical/production environment.
7+
Configuring approvals for environment promotion allows authorized users to control components being promoted to a critical/production environment.
88

99
Configuring approvals for the API subscription workflow allows you to create subscription plans that require approval before being activated. This feature allows you to control access to APIs by requiring administrative review and authorization of subscriptions before they become active.
1010

11+
## Permissions to create approval requests
12+
13+
=== "Environment promotion"
14+
15+
To submit an environment promotion approval request, a user must have required permissions to promote components or at least `WORKFLOW-MANAGEMENT >> Create approval requests` permission
16+
1117
## Permissions to review and respond to approval requests
1218

1319
Click the respective tab for details on permissions depending on the workflow for which you want to configure approvals:
@@ -16,7 +22,7 @@ Click the respective tab for details on permissions depending on the workflow fo
1622

1723
To review and respond to environment promotion approval requests, a user must have the following permissions. Administrators must ensure that users designated to review and respond to approval requests have these permissions:
1824

19-
- **WORKFLOW-MANAGEMENT**:
25+
- **WORKFLOW-MANAGEMENT**:
2026
- Approve component promotion requests: Grants access to review and approve the promotion of components to critical environments.
2127
- **PROJECT-MANAGEMENT**: Grants access to view and approve workflow requests. This is the same permission used to update or delete projects.
2228

@@ -26,7 +32,7 @@ Click the respective tab for details on permissions depending on the workflow fo
2632

2733
- **WORKFLOW-MANAGEMENT**:
2834
- Approve API subscriptions: Grants access to review and approve API subscription workflow requests.
29-
- **PROJECT-MANAGEMENT**:
35+
- **PROJECT-MANAGEMENT**:
3036
Grants access to view and approve workflow requests. This is the same permission used to update or delete projects.
3137

3238
## Set up an approval process for a workflow
@@ -49,10 +55,10 @@ To set up an approval process for a workflow, follow these steps:
4955

5056
!!! info "Important"
5157
Currently, there is no validation to ensure that the specified roles and assignees have the necessary permissions to review and respond to requests. If the [required permissions](#permissions-to-review-and-respond-to-approval-requests) are not correctly configured, some users may receive email notifications but will be unable to review the requests.
52-
58+
5359
7. Click **Save**. This configures and enables the approval process for the workflow.
5460

55-
Once you enable the approval process for a workflow, see the following details on how to submit a request for approval and the approval process. Click the respective tab depending on the workflow for which you enabled the approval process:
61+
Once you enable the approval process for a workflow, see the following details on how to submit a request for approval and the approval process. Click the respective tab depending on the workflow for which you enabled the approval process:
5662

5763
=== "Environment promotion"
5864

en/developer-docs/docs/administer/review-workflow-approval-requests.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,3 +29,6 @@ To approve or reject a request, follow these steps:
2929
Alternatively, click the Choreo Console link in the approval request email notification you received. This takes you to the request details in the Choreo Console.
3030
2. Review the request and click **Approve** or **Reject** based on your decision.
3131

32+
!!! note
33+
- An email will be sent to requestor mentioning details about the details
34+
- Currently, approver or other approvers will not receive an email, however action is recorded at Choreo databases.

en/developer-docs/docs/develop-components/submit-and-manage-workflow-approval-requests.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,15 @@ In Choreo, if an administrator [configures a workflow to require approval](../ad
44

55
Upon submitting a workflow approval request, Choreo notifies all authorized assignees via email about the [review request](../administer/review-workflow-approval-requests.md). When an authorized assignee approves or rejects the request, you will receive an email with details of the decision.
66

7-
The approach to request approval can vary depending on the workflow.
7+
The approach to request approval can vary depending on the workflow.
88

99
## Request approval for environment promotion
1010

1111
**Prerequisites**:
1212

1313
- Ensure you have a component created, built, and deployed to the development environment.
1414
- Ensure that an approval workflow is configured for environment promotion.
15+
- Ensure you need to have required permissions to promote components or `WORKFLOW-MANAGEMENT >> Create approval requests` permission
1516
- Ensure you are promoting the component to a critical environment, such as production.
1617

1718
To request approval to promote a component from the development environment to production, follow these steps:
@@ -29,6 +30,6 @@ When an authorized assignee approves the request, you will receive a confirmatio
2930

3031
## Cancel a workflow approval request
3132

32-
If you want to cancel a workflow approval request that is already submitted, you can do so before the request is approved or rejected.
33+
If you want to cancel a workflow approval request that is already submitted, you can do so before the request is approved or rejected.
3334

3435
When you submit a workflow approval request, the **Request to Promote** button changes to **Cancel Request**. To cancel an approval request, click **Cancel Request**. Upon confirming the cancellation, all configured approvers are notified immediately, and the request will no longer be pending.

0 commit comments

Comments
 (0)