Skip to content

Commit

Permalink
WMS: 11496 : Implementing Access Controls using Oracle Access Governa…
Browse files Browse the repository at this point in the history
…nce (#214)

* Update

* Update

* Update

* Update

* update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Update

* Create oracleuniversalauthenticator

* Delete oracleuniversalauthenticator

* Create oracleuniversalauthenticator

* Update

* Created new folder

* Update

* Update

* Update

* Update

* Update

* Update

* Update
  • Loading branch information
ibalasun authored Jun 26, 2024
1 parent d5a9121 commit 0a96996
Show file tree
Hide file tree
Showing 46 changed files with 119 additions and 66 deletions.
51 changes: 44 additions & 7 deletions accessgovernance-access-controls/access-control/access-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
5. Click on *Create*


## Task 3: Create an Approval Workflow
## Task 3: Create an Approval Workflow - Approval-Workflow-IT-Management

1. On the Access Governance console home page, click the Access Controls tab. Then, click Select on the Manage Approval Workflows tile.

Expand Down Expand Up @@ -130,9 +130,46 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.

![Approval Workflow](images/approval-workflow-name.png)

![Approval Workflow](images/approval-workflow-publish.png)


## Task 4: Create an Access Bundle
## Task 4: Create an Approval Workflow - One-level-approval

1. On the Access Governance console home page, click the Access Controls tab. Then, click Select on the Manage Approval Workflows tile.

![Approval Workflow](images/ag-homepage.png)

2. On the Approval Workflows page, your created approval workflows will be listed here. Click Create approval workflow to create your one-level-approval Workflow.


3. Let’s build your approval workflow now. Click the “+” button and configure your approval workflow based on the following:

• Which type of approval?: select Custom User

• Which user? Pamela Green

• Click Add

![Approval Workflow](images/custom-user.png)


After confirming your configuration matches the following, click Next

5. On the Add Details page, name your Approval Workflow: One-level-approval. Then, provide any description. Click Next to review your configurations so far, then click Publish and Approval workflow - **One-level-approval** has been created.

![Approval Workflow](images/approval-workflow-custom-user.png)

6. Enter the following details:

What do you want to call this approval process: One-level-approval

How do you want to describe this approval process: One-level-approval

![Approval Workflow](images/create-one-level.png)

Click Next and Publish.


## Task 5: Create an Access Bundle

1. On the Access Governance console home page, click the Access Controls tab. Then, click Select on the Access Bundles tile.

Expand Down Expand Up @@ -248,7 +285,7 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.

![Create Access Bundle](images/create-db-manage-access.png)

## Task 5: Create a Policy
## Task 6: Create a Policy

1. On the Access Governance console home page, click the Access Controls tab. Then, click Select on the Policies tile.

Expand Down Expand Up @@ -288,7 +325,7 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.

8. Finally, click Create.

## Task 6: Create Access Requests
## Task 7: Create Access Requests

1. Log in to Oracle Access Governance as an employee user - Mark Hernandez with the username and password.

Expand Down Expand Up @@ -376,7 +413,7 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
22. Click on **Submit Request**
## Task 7: Approve Access Requests
## Task 8: Approve Access Requests
1. Log in to Oracle Access Governance as an employee user - Pamela Green with the username and password.
Expand All @@ -397,7 +434,7 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
3. Under Actions, click on approve and Approve the request for the users Harlan Bullard, Mark Hernandez and Jerry Poland.
## Task 8: Run the Data Load
## Task 9: Run the Data Load
1. On the Access Governance console home page, navigate to Service Administration -> Connected System.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
128 changes: 72 additions & 56 deletions accessgovernance-access-controls/integrate-oag-db/integrate-oag-db.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,34 +93,29 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
## Task 4: Integrate with Oracle Identity Governance
1. On the Oracle Access Governance service home page *refer Lab 2:Task 1*, click on the Navigation Menu icon and select **Service Administration** and then **Connected Systems.**
1. On the Oracle Access Governance service home page *refer Lab 2:Task 1*, click on the Navigation Menu icon and select **Service Administration** and then **Orchestrated Systems.**
![Access Governance console - Connected Systems](images/connected-systems.png)
![Access Governance console - Connected Systems](images/ag-home.png)
2. Click on **Add a connected system**
![Access Governance console - Connected Systems](images/navigate-orchestrated-system.png)
![Add - Connected System](images/add-connected-system.png)
2. Click on **Add an orchestrated system**
3. On the tile labeled **Would you like to connect to an Identity Governance System** select the **Add** button.
![Access Governance console - Connected Systems-Add](images/connected-system-page.png)
![Add - Connected System](images/add-system.png)
4. Click **Close** on the information pop-up to navigate to the **Add an Identity Governance System** page and begin the configuration.
3. On the tile labeled **Select and configure a new orchestrated system**, select **Oracle Identity Governance** to configure the agent for a target Oracle Identity Governance connected system, and then click **Next.**
![Close the Pop-up window](images/pop-up.png)
![Add - Connected System](images/select-oig-system.png)
5. On the **Select System** step, select the tile for **Oracle Identity Governance** to configure the agent for a target Oracle Identity Governance connected system, and then click **Next.**
4. On the **Enter Details** step, enter the following details:
![Access Governance console - Connected Systems-Next](images/select-oig.png)
6. On the **Enter Details** step, enter the following details:
* **Name:** oag
* **Description:** oag
* **Name:** oig
* **Description:** oig
* **Click Next.**
![Access Governance console - Connected Systems-OIG](images/oag-select-system.png)
![Access Governance console - Connected Systems-OIG](images/enter-oig-system.png)
7. On the **Configure** step, enter connection details for the target system:
5. On the **Configure** step, enter connection details for the target system:
**JDBC URL:**
Replace the placeholder in the below url with the private ip of your compute instance. Refer to *Task 3 : Step 3* above for the private ip of your compute instance.
Expand Down Expand Up @@ -172,17 +167,14 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
<copy>Welcome1</copy>
```
![Configure Details](images/oag-connection-details.png)
![Configure Details](images/oig-connection-details.png)
8. On the Download Agent step, select the *Download link* and download the agent zip file. The zip file is present in: /home/opc/Downloads
6. On the Download Agent step, select the *Download link* and download the agent zip file. The zip file is present in: /home/opc/Downloads
![Download the agent](images/oag-download-link.png)
![Download the agent](images/oig-download-link.png)
9. You can verify the downloaded agent zip file.
7. You can verify the downloaded agent zip file.
![Navigate to file system](images/locate-zip.png)
![Verify the zip file](images/verify-zip.png)
Choose the option Customize before enabling the system for data loads. Click on **I'm done**
Expand All @@ -204,40 +196,35 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
![Enter Details](images/username-match-rule.png)
Navigate back to the connected system. Click on the Activate on the top-right corner.
To confirm, click on Activate .
The system is now **Active**. Click on **Load data** now to load the data.
Navigate back to the orchestrated system. It is in draft status.
![Enter Details](images/activate-oig.png)
If the connection details are successfully validated, you will see the **Success** status for the **Validate** operation. The Full Data Load operation may take upto a few minutes, depending upon the data available in your OCI tenancy. The incremental data load is run every four hours for this connected system to sync the data.
Click on **Activate**. Confirm the Activation of oig in the pop-up dialog box.
![Enter Details](images/oci-connection-status.png)
## Task 5: Install OAG Agent on the Compute Instance and Configure
## Task 5: Install OIG Agent on the Compute Instance and Configure
1. Open the terminal session.
![Open terminal session](images/open-terminal-window.png)
2. Move the downloaded zip file (oag.zip) present in the /home/opc/Downloads folder to /home/opc/zip_oag folder.
2. Move the downloaded zip file (oig.zip) present in the /home/opc/Downloads folder to /home/opc/zip_oag folder.
```
<copy>mv /home/opc/Downloads/oag.zip /home/opc/zip_oag</copy>
<copy>mv /home/opc/Downloads/oig.zip /home/opc/zip_oag</copy>
```
![Move the OAG Agent to zip_oag](images/move-oag-agent.png)
![Move the OAG Agent to zip_oag](images/move-file-command.png)
Verify the Agent zip (oag.zip) is present inside folder zip_oag.
Verify the Agent zip (oig.zip) is present inside folder zip_oag.
```
<copy>cd /home/opc/zip_oag</copy>
<copy>ls</copy>
```
![Verify the Agent zip oag.zip](images/env_setup.png)
3. Setting the Environment variables using the below command:
Expand All @@ -246,41 +233,53 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
<copy>source oag_agent.env</copy>
```
![Initialize the environment variable](images/terminal-oag.png)
![Verify the Agent zip oag.zip](images/environment-setup-command.png)
4. Install the agent
```
<copy>sh agentManagement.sh --volume /home/opc/vol_oag --agentpackage /home/opc/zip_oag/oag.zip --install</copy>
<copy>sh agentManagement.sh --volume /home/opc/vol_oag --agentpackage /home/opc/zip_oag/oig.zip --install</copy>
```
![Install the agent](images/agent-install.png)
![Install the agent](images/agent-install-terminal.png)
5. Start the agent
```
<copy>sh agentManagement.sh --volume /home/opc/vol_oag --start</copy>
```
![Start the agent](images/agent-start.png)
![Start the agent](images/agent-start-command.png)
6. Verify the agent
```
<copy>sh agentManagement.sh --volume /home/opc/vol_oag --status</copy>
```
![Verify the agent](images/agent-status.png)
![Verify the agent](images/agent-status-command.png)
Navigate back to the orchestrated system. Click on the Activate on the top-right corner.
To confirm, click on Activate .
The system is now **Active**. Click on **Load data** now to load the data.
If the connection details are successfully validated, you will see the **Success** status for the **Validate** operation. The Full Data Load operation may take upto a few minutes, depending upon the data available in your OCI tenancy. The incremental data load is run every four hours for this connected system to sync the data.
![Enter Details](images/oci-connection-status.png)
## Task 6: Connect to Oracle Database and download the DB Agent
1. Navigate to the **Connected Systems** page of the Oracle Access Governance Console, by following these steps:
From the Oracle Access Governance navigation menu icon **Navigation menu**, select **Service Administration** → **Connected Systems**.
Click the **Add a connected system** button to start the workflow.
1. Navigate to the **Orchestrated Systems** page of the Oracle Access Governance Console, by following these steps:
From the Oracle Access Governance navigation menu icon **Navigation menu**, select **Service Administration** → **Orchestrated Systems**.
Click the **Add an orchestrated system** button to start the workflow.
2. From the Add a Connected System page, Select the **Add** button on the **Would you like to connect to a database management system?** tile.
2. From the **Select and configure a new orchestrated system** page, select **Database User Management (Oracle DB)** and click **Next**.
3. On the Select system step of the workflow, Select **Database User Management (Oracle DB)** and click **Next**.
![Enter Details](images/select-oracle-db.png)
4. On the **Enter Details** step of the workflow, enter the details for the connected system:
Expand All @@ -289,7 +288,7 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
Click **Next**
![Add an Oracle DBUM Connected System](images/add-db-connected-system.png)
![Add an Oracle DBUM Connected System](images/name-oracle-db.png)
5. On the Configure step of the workflow, enter the configuration details required to allow Oracle Access Governance to connect to the target database.
Expand Down Expand Up @@ -320,13 +319,13 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
<copy>Welcome1</copy>
```
![Enter Details](images/enter-details-connected-system-1.png)
![Enter Details](images/configure-db.png)
6. Check the right hand pane to view What I've selected. If you are happy with the details entered, select **Add** to create the connected system.
7. On the Finish Up step of the workflow, you are asked to download the agent you will use to interface between Oracle Access Governance and Oracle Database. Select the **Download** link to download the agent zip file to the environment in which the agent will run. Click on **Activate** and **I'm done**
![Enter Details](images/click-activate.png)
![Enter Details](images/activate-db.png)
Expand Down Expand Up @@ -374,13 +373,30 @@ A valid Oracle OCI tenancy, with OCI administrator privileges.
## Task 8: Verify the Agent Installation
1. Login to the Oracle Access Governance Console, select the Navigation Menuicon to display the navigation menu.
2. In the Oracle Access Governance Console, select Service Administration → Connected Systems from the navigation menu.
3. On the Connected Systems screen, the tile showing the name of the connected system shows a status of Waiting for initial connection. Click on Manage Connection.
4. The Activity Log at the bottom of the page will show the status of the Validate operation, Pending while the agent comes up. If the agent does not come up, check the agent install and operation logs for any issues.
2. In the Oracle Access Governance Console, select Service Administration → Orchestrated Systems from the navigation menu.
3. Click on **Activate**
![Verify Connected System Configuration on UI](images/activate-oag-db.png)
4. Confirm **Activate** the orchestrated system.
![Verify Connected System Configuration on UI](images/confirm-activate.png)
5. The Orchestrated system is now in **Active** status.
![Verify Connected System Configuration on UI](images/active-db.png)
6. Click **Load Data** and confirm.
![Verify Connected System Configuration on UI](images/confirm-load-data.png)
7. On the Orchestrated Systems screen, the tile showing the name of the orchestrated system shows a status of Waiting for initial connection. Click on Manage Connection.
8. The Activity Log at the bottom of the page will show the status of the Validate operation, Pending while the agent comes up. If the agent does not come up, check the agent install and operation logs for any issues.
![Verify Connected System Configuration on UI](images/connection-succesful.png)
![Verify Connected System Configuration on UI](images/data-load-complete.png)
5. Once the agent has come up, the status of the Validate operation will show as Success.
9. Once the agent has come up, the status of the Validate operation will show as Success.Full Dataload has also been completed with status Success.
You may now **proceed to the next lab**.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,11 +49,11 @@ In this task, you will select the identities that you want to include in your se
1. In the Oracle Access Governance Console, navigate to Service Administration -> Manage Identities
![Navigate Manage Identities](images/navigate-manage-identities.png)
![Navigate Manage Identities](images/navigate-to-manage-identities.png)
2. Select **Any** condition match option.
![Manage Identities page](images/select-any.png)
![Manage Identities page](images/selec-any-condition.png)
3. Select the below options for the condition to match the identities that you want to include.
Expand All @@ -67,7 +67,7 @@ In this task, you will select the identities that you want to include in your se
5. Close the pop-up and click on **Save**
![Manage Identities page](images/identities-user.png)
![Manage Identities page](images/preview-identities-user.png)
You may now **proceed to the next lab**.
Expand Down

0 comments on commit 0a96996

Please sign in to comment.