Merge pull request #580 from oracle-devrel/oig-readme-updates

Update security asset, general and OIG README.md files

Author: SudhirTadiOracle

security/identity-and-access-management/README.md

@@ -6,17 +6,8 @@ The Identity and Access Management group under the Technology Engineering Securi
 - POCs with various integrations
 - Solution Assistance
 - Workshops to enable the partners/customers
-
-## Reusable Assets Overview
-
-**Note:** The below assets are provided for reference purposes only and for use in demos/PoC activities where required.
-
-- [Oracle Identity Governance SCIM Postman Samples](oracle-identity-governance/postman-scim-samples/README.md)
-- [Temporary User Disable Scheduled Task](oracle-identity-governance/scheduled-task-samples/temporary-user-disable/README.md)
-- [Access Extension Notification Scheduled Task](oracle-identity-governance/scheduled-task-samples/access-extension-notification/README.md)
-- [Extend Access WebService](oracle-identity-governance/webservice-samples/extend-access-ws/README.md)
 
-## Useful Links
+# Useful Links
 
 - [Identity & Access Management products page](https://www.oracle.com/in/security/identity-management/)
     - The one-stop products page for Oracle IAM products. Keep track of the latest added features, guides and future product developments.

security/identity-and-access-management/oracle-identity-governance/README.md

@@ -0,0 +1,57 @@
+# Oracle Identity Governance
+
+Oracle Identity Governance provides complete user lifecycle management and rich access entitlement controls across a wide range of services for both on-premises and cloud. Now supports microservices to discover common access patterns, optimize role-based access control, and automate the process of role publishing to Oracle Identity Governance. Oracle Identity Governance manages user provisioning and deprovisioning and provides actionable identity intelligence that enables rapid remediation of high-risk user entitlements.
+
+Review Date: 13.11.2023
+
+# General Product Links
+
+- [Oracle Identity Governance Product Page](https://www.oracle.com/security/identity-management/governance/)
+    - Official page for OIG
+- Oracle Identity Governance Documentation
+    - [OIG Public Documentation](https://docs.oracle.com/en/middleware/idm/suite/12.2.1.4/books.html)
+    - [OIG Connectors Documentation](https://docs.oracle.com/en/middleware/idm/identity-governance-connectors/12.2.1.3/index.html)
+
+# OIG Training & Live Labs
+
+## Oracle University OIG course
+
+In this course, you learn essential concepts about implementing identity management solutions with Oracle Identity Governance.
+
+- https://education.oracle.com/oracle-identity-governance-12c-essentials/courP_9411
+
+## Application Onboarding with Oracle Identity Governance (OIG)
+
+Application onboarding is the process of registering or associating an application with Oracle Identity Governance so that Oracle Identity Governance can provision or reconcile user information in or from that application.
+
+- https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=908
+
+## Oracle Identity Role Intelligence (OIRI) Workshop
+
+Oracle Identity Governance(OIG) is a powerful and flexible enterprise identity management system that automatically manages user's access privileges within enterprise IT resources. Oracle Identity Role Intelligence(OIRI) a new microservice avaialable as part of OIG suite is an intelligent, automated, and flexible way to optimize role-based access control (RBAC). OIRI Workshop provides hands on experience of deploying OIRI, importing data into OIRI from OIG, performing role mining in OIRI & publishing roles into OIG from OIRI.
+
+- https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=840
+
+## Oracle Identity Governance(OIG) One Hop Upgrade Workshop
+
+This workshop drives you through step by step upgrade process to be performed on a vanilla image of OIM 11g Release 2 (11.1.2.3.0) single node environment and on completion of step by step upgrade process the environment gets upgraded to OIG 12c (12.2.1.4.0).
+
+- https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=839
+
+# Reusable Assets Overview
+
+**Note:** The below assets are provided for reference purposes only and for use in demos/PoC activities where required.
+
+- [Oracle Identity Governance SCIM Postman Samples](oracle-identity-governance/postman-scim-samples/README.md)
+- [Temporary User Disable Scheduled Task](oracle-identity-governance/scheduled-task-samples/temporary-user-disable/README.md)
+- [Access Termination Notification Scheduled Task](oracle-identity-governance/scheduled-task-samples/access-termination-notification/README.md)
+- [Access Extension Notification Scheduled Task](oracle-identity-governance/scheduled-task-samples/access-extension-notification/README.md)
+- [Extend Access WebService](oracle-identity-governance/webservice-samples/extend-access-ws/README.md)
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

security/identity-and-access-management/oracle-identity-governance/postman-scim-samples/README.md

@@ -2,23 +2,25 @@
 
 A Postman collection of sample SCIM API requests for Oracle Identity Governance (OIG) that showcases the ability to quickly create organizations, managers and users via SCIM API calls. Note that these samples are meant for reference only and are not intended for use in production systems.
 
-## When to use this asset?
+Review Date: 13.11.2023
+
+# When to use this asset?
 
 The collection can be used for demonstration purposes, to showcase the SCIM capabilities of OIG or as a general reference in SCIM request automation.
 
-## How to use this asset?
+# How to use this asset?
 
-### Pre-requisites
+## Pre-requisites
 
 - The collection relies on collection variables in order to properly construct the SCIM queries. Before running any of the queries please ensure you update the `{{host}}` and `{{port}}` variables in order to point to the OIG environment you intend to use. In order to do that, access the "Variables" tab by first clicking on the Postman collection name. Feel free to also update the `{{organization_name}}` and manager user details as per your needs.
 - Open the "Authorization" tab of the "Get Authorization Token" request and update the credentials with a valid username and password. Any user with OIG API access (system administrators) can be used.
 
-### Executing the queries
+## Executing the queries
 
 - Make sure you run the queries in sequence, as you will first need a valid `{{access_token}}`, then a valid `{{organization_id}}` to create the manager and reportees from the sample CSV file.
 - Use the "Run Collection" batch functionality in Postman on the "Create User(s) CSV" request in order to import all the sample user entries in the provided CSV file (or from one of your own choosing). Note that the sample CSV file and all user names are provided only for reference. Any similarity to actual persons is purely coincidental and unintended.
 
-## Useful Links
+# Useful Links
 
 - [Oracle Identity Governance SCIM API reference](https://docs.oracle.com/en/middleware/idm/identity-governance/12.2.1.4/omdev/using-scim-rest-services.html)
 - [Postman collections guide](https://learning.postman.com/docs/collections/collections-overview/)

security/identity-and-access-management/oracle-identity-governance/scheduled-task-samples/access-extension-notification/README.md

@@ -6,21 +6,23 @@ The scheduled task needs to be used in conjunction with the Extend Access WebSer
 
 Developed on and compatible with OIG 11g R2 PS3 and above.
 
-## When to use this asset?
+Review Date: 13.11.2023
+
+# When to use this asset?
 
 When there's a need to provide or demonstrate the functionality described above or something similar, which can be adapted from the provided code.
 
-## How to use this asset?
+# How to use this asset?
 
-### Pre-requisites and dependencies
+## Pre-requisites and dependencies
 
 The scheduled task uses the `javax.mail` interface in order to send emails, and also parts of the `jaxb-api` interface for generating UUIDs.
 
 As such, the following jar files are required as dependencies and need to be used during the build process, **and also uploaded as third party jars** to the OIM deployment node:
 - javax.mail.jar
 - jaxb-api-2.3.1.jar
 
-### Building and deployment
+## Building and deployment
 
 Here's a short build and deployment checklist:
 
@@ -33,7 +35,7 @@ Here's a short build and deployment checklist:
 
 Please see the useful link below for detailed build and deployment steps.
 
-### Executing the scheduled task
+## Executing the scheduled task
 
 The following items need to be populated as part of the scheduled job parameters:
 - Days Before Expiration: Number of days before the email is sent, e.g. 7
@@ -47,7 +49,7 @@ The following items need to be populated as part of the scheduled job parameters
 
 [Consult this section](https://docs.oracle.com/en/middleware/idm/identity-governance/12.2.1.4/omusg/managing-jobs-1.html#GUID-71BB3623-AEE2-4F64-BBD4-D921DCA39D7C) on how to manually start or schedule a job.
 
-## Useful Links
+# Useful Links
 
 [Oracle Identity Governance developer's guide - Developing scheduled tasks](https://docs.oracle.com/en/middleware/idm/identity-governance/12.2.1.4/omdev/developing-scheduled-tasks.html#GUID-F62EF833-1E70-41FC-9DCC-C1EAB407D151)
 

security/identity-and-access-management/oracle-identity-governance/scheduled-task-samples/access-termination-notification/README.md

@@ -6,13 +6,15 @@ In case access extensions or a more complex handling of email contents are also
 
 Developed on and compatible with OIG 11g R2 PS3 and above.
 
-## When to use this asset?
+Review Date: 13.11.2023
+
+# When to use this asset?
 
 When there's a need to provide or demonstrate the functionality described above or something similar, which can be adapted from the provided code.
 
-## How to use this asset?
+# How to use this asset?
 
-### Building and deployment
+## Building and deployment
 
 Here's a short build and deployment checklist:
 
@@ -24,15 +26,15 @@ Here's a short build and deployment checklist:
 
 Please see the useful link below for detailed build and deployment steps.
 
-### Executing the scheduled task
+## Executing the scheduled task
 
 The following items need to be populated as part of the scheduled job parameters:
 - Days Before Expiration: Number of days before the email is sent, e.g. 7
 - Email Template Name: Email template name for the email, e.g. Access_Termination_Template
 
 [Consult this section](https://docs.oracle.com/en/middleware/idm/identity-governance/12.2.1.4/omusg/managing-jobs-1.html#GUID-71BB3623-AEE2-4F64-BBD4-D921DCA39D7C) on how to manually start or schedule a job.
 
-## Useful Links
+# Useful Links
 
 [Oracle Identity Governance developer's guide - Developing scheduled tasks](https://docs.oracle.com/en/middleware/idm/identity-governance/12.2.1.4/omdev/developing-scheduled-tasks.html#GUID-F62EF833-1E70-41FC-9DCC-C1EAB407D151)
 

security/identity-and-access-management/oracle-identity-governance/scheduled-task-samples/temporary-user-disable/README.md

@@ -6,13 +6,15 @@ Can be used as a basis to demonstrate or further customize a "leave of absence"
 
 Developed on and compatible with OIG 11g R2 PS3 and above.
 
-## When to use this asset?
+Review Date: 13.11.2023
+
+# When to use this asset?
 
 When there's a need to provide or demonstrate the functionality described above or something similar, which can be adapted from the provided code.
 
-## How to use this asset?
+# How to use this asset?
 
-### Building and deployment
+## Building and deployment
 
 Here's a short build and deployment checklist:
 
@@ -23,13 +25,13 @@ Here's a short build and deployment checklist:
 
 Please see the useful link below for detailed build and deployment steps.
 
-### Executing the scheduled task
+## Executing the scheduled task
 
 - Ensure you have specified a relevant value for the `Temporary disable date user attribute` scheduler parameter field in the scheduled task definition. Note that a either a UDF (User-defined field) or a pre-existing user attribute can be used. This value needs to contain the attribute's display label, not the backend name (e.g., `User Login`, not `USR_LOGIN`).
 
 - [Consult this section](https://docs.oracle.com/en/middleware/idm/identity-governance/12.2.1.4/omusg/managing-jobs-1.html#GUID-71BB3623-AEE2-4F64-BBD4-D921DCA39D7C) on how to manually start or schedule a job.
 
-## Useful Links
+# Useful Links
 
 [Oracle Identity Governance developer's guide - Developing scheduled tasks](https://docs.oracle.com/en/middleware/idm/identity-governance/12.2.1.4/omdev/developing-scheduled-tasks.html#GUID-F62EF833-1E70-41FC-9DCC-C1EAB407D151)
 

security/identity-and-access-management/oracle-identity-governance/webservice-samples/extend-access-ws/README.md

@@ -6,13 +6,15 @@ The scheduled task needs to be used in conjunction with the Access Extension Not
 
 Developed on and compatible with OIG 11g R2 PS3 and above.
 
-## When to use this asset?
+Review Date: 13.11.2023
+
+# When to use this asset?
 
 When there's a need to provide or demonstrate the functionality described above or something similar, which can be adapted from the provided code.
 
-## How to use this asset?
+# How to use this asset?
 
-### Pre-requisites and dependencies
+## Pre-requisites and dependencies
 
 The WebService is build using the JAX-RS specification and API.
 
@@ -42,7 +44,7 @@ To connect to an OIM node, the service will also use a full OIM client, and will
 
 Note that this is a full OIM client. On more details about exporting a full OIM client jar file, please consult the developer's guide linked below.
 
-### Building and deployment
+## Building and deployment
 
 A complete WebContent deployment configuration is provided as a sample, please use it and extend it as needed.
 
@@ -57,7 +59,7 @@ Here's a short build and deployment checklist:
 
 Please see the useful link below for detailed build and deployment steps.
 
-## Useful Links
+# Useful Links
 
 [The Java API for RESTful Web Services (JAX-RS)](https://www.oracle.com/technical-resources/articles/java/jax-rs.html)
 [JSR 311: JAX-RS: The JavaTM API for RESTful Web Services](https://jcp.org/en/jsr/detail?id=311)