OAG DBAT integration asset

Author: mgere-oracle

security/identity-and-access-management/oracle-access-governance/dbat-os-accounts-sample/README.md

@@ -25,7 +25,7 @@ The following components are required and assumed to already be available in thi
 
 Please ensure the requirements listed above have been satisfied.
 
-Once a database installation/instance is available follow the below steps to deploy the provided sample SQL schema:
+**Once a database installation/instance is available** follow the below steps to deploy the provided sample SQL schema:
 
 1. Connect to the database as dba (with sysdba role) and create a schema user for the purposes of the integration, by running:
 
@@ -55,17 +55,24 @@ GRANT DROP ANY PROCEDURE TO OAG;
 
 2. Connect to the database as the newly create OAG user (using the password you've set with the above command), and execute the `OS_Account.sql` file. This will create all the quired table schema and populate it with sample data.
 
-In order to achieve the integration in Oracle Access Governance, follow the below steps to create a new orchestrated system:
+**In order to achieve the DBAT integration in Oracle Access Governance**, follow the below steps to create a new orchestrated system:
+
+**Note:** The Connect URL format provided below is meant for pluggable databases using DB service names. Please adjust it as needed. All types of jdbc URL formats are supported, including basic SID-based URLs such as: `jdbc:oracle:thin:@hostname:port:SID`.
+
+1. Go to **Service Administration -> Manage orchestrated systems**.
+2. Click on **+ Add an Orchestrated system**.
+3. In the **Select System** step, pick `Database Application Table (Oracle DB)`, and click on Next.
+4. In the **Enter Details** step, enter the details provided below. Optionally untick `This is the authoritative source for my identities.` should you want to create the identities through other means, otherwise, for the purposes of this example, the identities will be imported using data from the **OS_ACCOUNT** table. Click on Next.
+
+```
+What do you want to call this system?: OS Account
+How do you want to describe this system: OS level user account
+```
 
-1. Go to Service Administration -> Manage orchestrated systems.
-2. Click on + Add an Orchestrated system.
-3. In the "Select System" step, pick `Database Application Table (Oracle DB)`, and click on Next.
-4. In the "Enter Details" step, enter the following details: ```What do you want to call this system?: OS Account
-How do you want to describe this system: OS level user account``` Optionally untick `This is the authoritative source for my identities.` should you want to create the identities through other means, otherwise for the purposes of this example, the identities will be imported using data from the OS_ACCOUNT table. Click on Next.
 5. Click on Confirm if you are using both authoritative and manager permission integration modes.
-6. In the "Add Owners" step, use the default values and click on Next.
-7. In the "Account Settings" step, use the default values and click on Next.
-8. In the "Integration" step, enter the following details, adjusted to your particular deployment settings. Leave the rest of the fields on their default values, and click on Add.
+6. In the **Add Owners** step, use the default values and click on Next.
+7. In the **Account Settings** step, use the default values and click on Next.
+8. In the **Integration** step, enter the following details, adjusted to your particular deployment settings. Leave the rest of the fields on their default values, and click on Add.
 
 ```
 Easy Connect URL for Oracle Database: jdbc:oracle:thin:@//hostname:port/dbservicename
@@ -82,11 +89,9 @@ User account table password column mapping: OS_ACCOUNT:PASSWORD
 User account table status column mapping: OS_ACCOUNT:STATUS
 ```
 
-9. On the "Finish up" step, first click on the `Download` link and save the agent package, then select `Activate and prepare the data load with the provided defaults` and click on I'm done.
+9. On the **Finish up** step, first click on the `Download` link and save the agent package, then select `Activate and prepare the data load with the provided defaults` and click on I'm done.
 10. Use the downloaded `OS_Account.zip` archive to deploy the OAG agent as per the steps covered in [this guide](https://docs.oracle.com/en/cloud/paas/access-governance/lllho/index.html#GUID-67A8B48F-9358-4B95-A36C-5871E3726FAB). Once the agent is deployed and started, it will automatically validate the configurations and import the data into OAG, and you can start using the integration.
 
-**Note:** The above URL format is meant for pluggable databases using DB service names. Please adjust it as needed. All types of jdbc URL formats are supported, including basic SID-based URLs such as: `jdbc:oracle:thin:@hostname:port:SID`.
-
 Please also see the useful link below for more detailed deployment steps.
 
 # Useful Links