diff --git a/nyc-genai-lab/3-configure-oci/3-configure-oci-ocw24.md b/nyc-genai-lab/3-configure-oci/3-configure-oci-ocw24.md new file mode 100644 index 000000000..91d12428a --- /dev/null +++ b/nyc-genai-lab/3-configure-oci/3-configure-oci-ocw24.md @@ -0,0 +1,76 @@ +# Create the Web Credentials + +## Introduction + +In this workshop, you use OCI Generative AI as the AI provider to build a conversational chatbot. To use the OCI Generative AI Service in APEX, you will use the keys provided in the lab [Your OCI GenAI key](?lab=tut3253). + +Note: OCI Generative AI service is available in limited regions. If you are using your own cloud tenancy, check to see if your cloud region supports OCI Generative AI service, visit the [documentation](https://docs.oracle.com/en-us/iaas/Content/generative-ai/overview.htm#regions). + +Estimated Time: 10 Minutes + +### Objectives +In this lab, you: + +- Create Web Credentials in Oracle APEX + +## Prerequisites +- Download the zip file from [Your OCI GenAI key](?lab=tut3253) + +## Task 1: Create Web Credentials in Oracle APEX + +Web credentials are used to authenticate connection to external REST services, or REST Enabled SQL services from APEX. + +Creating Web Credentials securely stores and encrypts authentication credentials for use by Oracle APEX components and APIs. Credentials cannot be retrieved back in clear text. Credentials are stored at the workspace level and therefore are visible to all applications. + +To create a Web Credential in Oracle APEX: + +1. Login into your Oracle APEX workspace. + + ![Login into your APEX account](images/apex-login.png " ") + +2. On the Workspace home page, click **App Builder**. + + ![Click App Builder](images/app-builder1.png " ") + +3. Click **Workspace Utilities**. + + ![Click Workspace Utilities](images/workspace-utilities.png " ") + +4. Select **Web Credentials**. + + ![Click Web Credentials](images/sc-web-creds.png " ") + +5. Click **Create**. + + ![Create Web Credentials](images/create-wc.png " ") + +6. Enter the following details using the configuration file you copied in the previous task. + + - **Name**: apex\_ai\_cred + + - **Authentication Type**: OCI Native Authentication + + - **OCI User ID**: Enter the OCID of the Oracle Cloud user Account. You can find the OCID in the zip folder you downloaded as part os prerequisites. + Your OCI User ID looks similar to **ocid1.user.oc1..aaaaaaaa\*\*\*\*\*\*wj3v23yla** + + - **OCI Private Key**: Open the private key (.pem file) downloaded in the previous task. Copy and paste the API Key. + + ![Private key file](images/private-key.png " ") + + - **OCI Tenancy ID**: Enter the OCID for Tenancy. Your Tenancy ID looks similar to **ocid1.tenancy.oc1..aaaaaaaaf7ush\*\*\*\*cxx3qka** + + - **OCI Public Key Fingerprint**: Enter the Fingerprint ID. Your Fingerprint ID looks similar to **a8:8e:c2:8b:fe:\*\*\*\*:ff:4d:40** + + ![Web Credentials page](images/web-creds.png " ") + +5. Click **Create**. + +## Summary + +You now know how to create web credentials in Oracle APEX. + +You may now **proceed to the next lab**. + +## Acknowledgments +- **Author** - Apoorva Srinivas, Senior Product Manager +- **Last Updated By/Date** - Apoorva Srinivas, Senior Product Manager, August 2024 diff --git a/nyc-genai-lab/workshops/ocw24/index.html b/nyc-genai-lab/workshops/ocw24/index.html new file mode 100644 index 000000000..aaac634be --- /dev/null +++ b/nyc-genai-lab/workshops/ocw24/index.html @@ -0,0 +1,62 @@ + + + + + + + + + Oracle LiveLabs + + + + + + + + + + + + +
+
+
+
+
+
+
+
+ + + + + diff --git a/nyc-genai-lab/workshops/ocw24/manifest.json b/nyc-genai-lab/workshops/ocw24/manifest.json new file mode 100644 index 000000000..e679ded07 --- /dev/null +++ b/nyc-genai-lab/workshops/ocw24/manifest.json @@ -0,0 +1,53 @@ +{ + "workshoptitle": "Build an Innovative Q&A Interface Powered by Generative AI with Oracle APEX", + "help": "livelabs-help-apex_us@oracle.com", + "tutorials": [ + { + "title": "Introduction", + "filename": "../../0-intro/0-intro.md" + }, + { + "title": "Get Started", + "description": "Prerequisites for LiveLabs (Oracle-owned tenancies). The title of the lab and the Contents Menu title (the title above) match for Prerequisite lab. This lab is always first.", + "filename": "https://oracle-livelabs.github.io/common/labs/cloud-login/cloud-login-livelabs2.md" + }, + { + "title": "Sign up for an APEX Workspace", + "filename": "../../../common-241/1-sign-up-apex/sign-up-apex-sandbox.md" + }, + { + "title": "Your OCI GenAI key", + "filename": "https://oracle-livelabs.github.io/common/labs/ocw24/tut3253.md" + }, + { + "title": "Lab 1: Create an APEX App", + "filename": "../../1-create-app/1-create-app.md" + }, + { + "title": "Lab 2: Visualize Schools on a Map", + "filename": "../../2-schools-on-map/2-schools-on-map.md" + }, + + { + "title": "Lab 3: Create the Web Credentials", + "filename": "../../3-configure-oci/3-configure-oci-ocw24.md" + }, + { + "title": "Lab 4: Build a Conversational Inquiry using Generative AI", + "filename": "../../4-using-genai/4-using-genai.md" + }, + { + "title": "Lab 5: Generate Email to Apply to a School using Gen AI", + "filename": "../../5-apply-to-school/5-apply-to-school.md" + }, + { + "title": "Lab 6: Run the Application", + "filename": "../../6-run-app/6-run-app.md" + }, + { + "title": "Need Help?", + "description": "Solutions to Common Problems and Directions for Receiving Live Help", + "filename":"https://oracle-livelabs.github.io/common/labs/need-help/need-help-livelabs.md" + } + ] +}