Merge branch 'main' into review-and-fixes

Author: martatolosa

.github/workflows/banned_file_changes_pr.yml

@@ -3,7 +3,7 @@ on:
   # pull_request:
   #   branches: [ "**/*" ]
   pull_request_target:
-  
+
 jobs:
   check_for_banned_file_changes:
     name: Look for unsupported (banned) file modifications on PRs
@@ -31,7 +31,7 @@ jobs:
           echo 'Changes to files in .github are not allowed.'
       - name: Comment if .github changed
         if: contains(steps.files.outputs.all_files_changed, '.github')
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :no_entry: **Banned Files Modified**
@@ -43,15 +43,15 @@ jobs:
           echo 'Changes to license_policy.yml are not allowed.'
       - name: Comment if license_policy.yml changed
         if: contains(steps.files.outputs.all_files_changed, '"license_policy.yml"')
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :no_entry: **Banned Files Modified**
             Changes to `license_policy.yml` are not permitted.  Please revert your changes and re-submit a new PR.  Simply changing the file back to its original state and re-committing won't work (you must revert the changes made to it).
           repo-token: ${{ secrets.GITHUB_TOKEN }}
       - name: Look for changes to repolinter.json
         if: contains(steps.files.outputs.all_files_changed, '"repolinter.json"')
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :no_entry: **Banned Files Modified**
@@ -63,7 +63,7 @@ jobs:
           echo 'Changes to repolinter.json are not allowed.'
       - name: Look for changes to sonar-project.properties
         if: contains(steps.files.outputs.all_files_changed, '"sonar-project.properties"')
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :no_entry: **Banned Files Modified**

.github/workflows/license_audit.yml

@@ -31,7 +31,7 @@ jobs:
         run: echo "${{ steps.analysis.outputs.unapproved_licenses }}"
       - name: Comment if analysis finds unapproved licenses
         if: steps.analysis.outputs.unapproved_licenses == 'true'
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :no_entry: **License Inspection**

.github/workflows/repolinter.yml

@@ -34,7 +34,7 @@ jobs:
           echo "Errored: ${{ steps.analysis.outputs.errored }}"
       - name: Comment if analysis finds missing disclaimer
         if: steps.analysis.outputs.disclaimer_found == 'false'
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :no_entry: **FAILURE: Missing Disclaimer**
@@ -47,34 +47,34 @@ jobs:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
       - name: Comment if analysis finds missing readme
         if: steps.analysis.outputs.readme_file_found == 'false'
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :no_entry: **FAILURE: Missing README**
             The README file seems to be missing.  Please add it.
-            
+
             Details:
             ${{ steps.analysis.outputs.readme_file_details }}
           repo-token: ${{ secrets.GITHUB_TOKEN }}
       - name: Comment if analysis finds missing license
         if: steps.analysis.outputs.license_file_found == 'false'
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :no_entry: **FAILURE: Missing LICENSE**
             The LICENSE file seems to be missing.  Please add it.
-            
+
             Details:
             ${{ steps.analysis.outputs.license_file_details }}
           repo-token: ${{ secrets.GITHUB_TOKEN }}
       - name: Comment if analysis finds copyright notice missing
         if: steps.analysis.outputs.copyright_found == 'false'
-        uses: oracle-devrel/add-pr-comment@v1
+        uses: oracle-devrel/add-pr-comment
         with:
           message: |
             :warning: **WARNING: Missing Copyright Notice(s)**
             It's a good idea to have copyright notices at the top of each file.  It looks like at least one file was missing this (though it might be further down in the file - this might be a false-positive).
-            
+
             Details:
             ${{ steps.analysis.outputs.copyright_details }}
           repo-token: ${{ secrets.GITHUB_TOKEN }}

data-platform/core-converged-db/database-23ai/README.md

@@ -15,6 +15,7 @@ Reviewed: 21.08.2024
 - [Database 23ai: Feature Highlights on oracle.com](https://www.oracle.com/database/23ai/)
 - [Online documentation for Oracle Database 23ai](https://docs.oracle.com/en/database/oracle/oracle-database/23/index.html)
 - [Oracle Database 23ai New Features](https://docs.oracle.com/en/database/oracle/oracle-database/23/nfcoa/)
+- [New Features in 23ai Release Updates](https://docs.oracle.com/en/database/oracle/oracle-database/23/nfcoa/release_updates.html)
 - [Features and Licensing page](https://apex.oracle.com/database-features/)
 - [Oracle Interactive Technical Architecture Diagrams](https://docs.oracle.com/en/database/oracle/oracle-database/23/aliad/iad_home.html)
 - [Oracle Release Analyzer Diff Utility](https://oradiff.oracle.com/ords/r/oradiff/oradiff/home?session=226168768557352)
@@ -97,6 +98,7 @@ Reviewed: 21.08.2024
 - [23ai blogs on blogs.oracle.com/coretec](https://blogs.oracle.com/coretec/category/cased-concurrency-control-rt-23ai)
 
 ## Videos
+- [Lock-Free Row Updates in Oracle Database using ETAGs](https://youtu.be/zfurzMlY3iI)
 - [Generative AI integration with DBMS_CLOUD_AI](https://youtu.be/V2x3XtibrjM)
 - [Monitoring, Analyzing and Diagnosing SQL Statements](https://youtu.be/rbxNPetPH7c)
 - [JSON Relational Duality Views](https://youtu.be/YMftyjrEpnU)

data-platform/core-converged-db/db-json/README.md

@@ -3,7 +3,7 @@
 The Oracle Database provides various perspectives for viewing and accessing JSON data. One can view it from the SQL database point of view or from the document or collection view that comes with tools and APIs like SODA (short for Simple Oracle Document Access). With SODA you can create and store collections of documents in the Oracle Database, and retrieve, without needing to know SQL or how the documents are stored in the database. Documents can be fetched from the database by key lookup or by using query-by-example (QBE) pattern-matching. Regardless of the chosen perspective, the benefits of using Oracle Database as a Converged Database are always included. 
 In release 23, JSON Relational Duality, one of the highlights for JSON developers delivers a solution that provides the benefits of both relational tables and JSON documents, without the tradeoffs of either model. Using Duality Views, data is still stored in relational tables in a highly efficient normalized format but is accessed by apps in the form of JSON documents. 
 
-Reviewed Date: 19.8.2024
+Reviewed Date: 30.10.2024
 
 # Useful Links
 
@@ -13,7 +13,7 @@ Reviewed Date: 19.8.2024
 - [JSON Developer's Guide 23](https://docs.oracle.com/en/database/oracle/oracle-database/23/adjsn/index.html#Oracle%C2%AE-Database)
 - [JSON-Relational Duality Developer's Guide 23](https://docs.oracle.com/en/database/oracle/oracle-database/23/jsnvu/index.html#Oracle%C2%AE-Database)
 - [Simple Oracle Document Access (SODA)](https://docs.oracle.com/en/database/oracle/simple-oracle-document-access)
-- [Using SQL/JSON Function JSON_VALUE With a Boolean JSON Value](https://docs.oracle.com/en/database/oracle/oracle-database/23/adjsn/function-JSON_VALUE.html#GUID-FD4E6FFA-8865-4682-B66A-79F77CBACD50)
+- [New Features in 23ai Release Updates](https://docs.oracle.com/en/database/oracle/oracle-database/23/nfcoa/release_updates.html)
 
 ## Blogs
 
@@ -35,10 +35,10 @@ Reviewed Date: 19.8.2024
 - [Tutorial: JSON in the Oracle Database](https://blogs.oracle.com/coretec/post/tutorial1-json-in-oracle)
 - [NoSQL-style API SODA for beginners](https://blogs.oracle.com/coretec/post/nosql-style-api-soda-for-beginners)
 - [JSON Relational Duality Views on Github](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/core-converged-db/database-23c/json-relational-duality-views)
-- [MongoDB API 23c Workshop](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/core-converged-db/mongodb-api/workshop)
 
 ## Videos
 
+- [Lock-Free Row Updates in Oracle Database using ETAGs](https://youtu.be/zfurzMlY3iI)
 - [JSON Relational Duality Views](https://youtu.be/YMftyjrEpnU)
 - [JSON in Oracle Database 23ai](https://www.youtube.com/watch?v=KMgsb-BWWc0&list=PLHA__TOeNI7MNBND0JWQUqTYOQ1up-VHX&pp=gAQBiAQB)
 - [Materialized Views on JSON Collection Tables](https://youtu.be/C2wXcJyJjUE)

security/identity-and-access-management/oracle-identity-governance/event-handler-samples/password-reset-on-user-role-change/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2024 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

security/identity-and-access-management/oracle-identity-governance/event-handler-samples/password-reset-on-user-role-change/README.md

@@ -0,0 +1,46 @@
+# Password Reset On User Role Change Event Handler
+
+This asset contains the code and deployment items for an event handler that automatically triggers a password reset flow for a user once a user's role attribute changes.
+
+Note that by "user role" we are reffering to the user's role attribute (also known as "employee type") in this context, not to changes in a user's membership to any particular OIG role.
+
+Developed on and compatible with OIG 11g R2 PS3 and above.
+
+Review Date: 28.10.2024
+
+# 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.
+
+Note that password resets for lifecycle events involving other attribute value changes, such as for example a user's parent Organization, can be easily retrofitted based on the provided sample.
+
+# How to use this asset?
+
+## Building and deployment
+
+Here's a short build and deployment checklist:
+
+1. Generate a jar file containing the sample code.
+2. Copy the jar file under the `lib` directory of the provided `plugin` folder structure and create a zip file with the following root structure:
+- lib
+- META-INF
+- plugin.xml
+3. Register the plugin zip file to an OIG environment using OIG's plugin registration utility script.
+
+Please see the useful link below for detailed build and deployment steps.
+
+## How do I execute the event handler?
+
+Once registered the code will be run automatically when user lifecycle events occur in the system. Note that password resets will be triggered only when the target attribute value changes (in this sample, the user's role), during modify events.
+
+# Useful Links
+
+[Oracle Identity Governance developer's guide - Developing plugins](https://docs.oracle.com/en/middleware/idm/identity-governance/12.2.1.4/omdev/developing-plug-ins.html#GUID-7F4EE3EA-076C-45DB-B13D-2905AB5AF6CB)
+
+# License
+
+Copyright (c) 2024 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/event-handler-samples/password-reset-on-user-role-change/files/plugin/META-INF/EventHandlers.xml

@@ -0,0 +1,15 @@
+<?xml version='1.0' encoding='utf-8'?>
+<eventhandlers xmlns="http://www.oracle.com/schema/oim/platform/kernel"
+xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+xsi:schemaLocation="http://www.oracle.com/schema/oim/platform/kernel
+orchestration-handlers.xsd">
+	<!-- Custom preprocess event handlers -->
+	<action-handler
+	class="com.oracle.sample.PasswordResetOnUserRoleChange"
+	entity-type="User"
+	operation="MODIFY"
+	name="PasswordResetOnUserRoleChange"
+	stage="preprocess"
+	order="999"
+	sync="TRUE"/>
+</eventhandlers>

security/identity-and-access-management/oracle-identity-governance/event-handler-samples/password-reset-on-user-role-change/files/plugin/lib/README.txt

@@ -0,0 +1,8 @@
+Place the plugin jar file in this directory before creating the plugin zip file.
+
+Note the zip file structure must contain:
+- lib
+- META-INF
+- plugin.xml
+
+Do NOT create an archive of the entire plugin directory, only of its contents, as specified above.

security/identity-and-access-management/oracle-identity-governance/event-handler-samples/password-reset-on-user-role-change/files/plugin/plugin.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<oimplugins>
+	<plugins pluginpoint="oracle.iam.platform.kernel.spi.EventHandler">
+		<plugin pluginclass="com.oracle.sample.PasswordResetOnUserRoleChange"
+		version="1.0"
+		name="PasswordResetOnUserRoleChange">
+		</plugin>
+	</plugins>
+</oimplugins>