Skip to content

Commit

Permalink
Pull request for Get Started with Oracle Data Safe Fundamentals works…
Browse files Browse the repository at this point in the history
…hop (#199)

* Updates from Michaels feedback

* Cloud World updates

* Cloud World 2022

* Updates after Bettina's review

for cloud world 2022

* Data Masking role

Moved Data Masking role grant to Data Masking lab

* Message about filter

* Fixes after dev review

* fixes based on Dev feedback

* Tiger Team training update

Went through all labs and updated most screenshots and updated instructions where needed. Also added a few new features.

* Updates for Tiger Team

* Update prepare-environment.md

Updated this file to work for both workshops

* Files for an advanced workshop for tiger team training

* Update api-copy-audit-data.md

Based on Anna's feedback

* Update api-copy-audit-data.md

Fixed up the copy of code

* Update api-schedule-audit-data-copy.md

* Update api-schedule-audit-data-copy.md

* Update api-schedule-audit-data-copy.md

* With errors

* Update api-copy-audit-data.md

* Update api-copy-audit-data.md

* Update api-copy-audit-data.md

Removed installing the SDK because it's already installed on Cloud Shell. An updated java file is required.

* Update api-copy-audit-data.md

* Updated

* Updates

* Update manifest.json

* Update introduction-adv.md

* Update cli.md

* Update api-copy-audit-data.md

* Update cli.md

* Update cli.md

* Updated based on Bettina's feedback

* Updated screenshots for new OCI interface

* update

* updates for 2nd workshop

* Q/A testing updates

* lint checker Q/A updates

* updates for integration workshop

* Testing

* update for timings

* Added Proceed to next lab

* Removed Data Safe enablement step

April 11th, Data Safe is enabled during target registration behind the scenes.

* OCI menu change

* Added folders for Cloud World 2023

* OCW2023

Initial changes for Bettina

* Updated steps for Oracle Cloud World files

Note: Graphics still need to be updated.

* Update manifest.json

* Added graphics and did a run through

* Updates after dry run on June 7

* Updates for quarterly Q/A

* Autonomous Database Serverless name change

* Updates for Cloud World

* updated title of HOL

* Added videos

* Updates for new features in Data Safe

All labs are updated

* Update assess-database-users.md

mentioned schema access

* Updated workshop with current interface and streamlined labs 3 and 4

* Updated capitalization, dates, and minor things

* Updated capitilizations

* temporary fix added for java example file

* Updated before go-live

* updated graphics to deal with Notifications tab

* updated SQL script

* fix

* Fixed brackets on permissions

* sql firewall

* sql firewall

* sql firewall

* sql firewall

* sql firewall revamp of labs

* Fixing error in column name

COUNTRY_ID should be COUNTRY_ABBREV

* Updates for Database Actions

updated a few screenshots

* ai

* Updates for OpenWorld2024

* OpenWorld update

* CloudWorld updates

* Update access-environment-ocw-sandbox.md

* new environment updates

* New environment updates
  • Loading branch information
joglover authored May 17, 2024
1 parent f76a226 commit a4da832
Show file tree
Hide file tree
Showing 36 changed files with 657 additions and 91 deletions.
133 changes: 133 additions & 0 deletions data-safe/access-environment/access-environment-ocw-sandbox.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
# Access your environment

## Introduction

In this lab, you access and review your LiveLabs Sandbox environment in Oracle Cloud Infrastructure. Your environment comes with a tenancy, a compartment, an Oracle Cloud account in the LiveLabs tenancy, and a pre-provisioned Autonomous Database. Sample data is loaded into your database and your database is registered with Oracle Data Safe.


Estimated Lab Time: 5 minutes

### Objectives

In this lab, you will:

- View your LiveLabs reservation information and sign in
- Access Oracle Data Safe and view your registered target database
- (Optional) Explore Security Center
- Access Oracle Database Actions


### Prerequisites

This lab assumes you have:

- Obtained an Oracle Cloud account and signed in to the Oracle Cloud Infrastructure Console at `https://cloud.oracle.com`


## Task 1: View your LiveLabs Sandbox reservation information and sign in

1. In the upper-left corner of the lab instructions page (this page), click the **View Login Info** link.

A **Reservation Information** panel is displayed.

2. Review the information. You are provided with the following in Oracle Cloud Infrastructure:

- Access to one of the LiveLab's tenancies
- A link that directs you to the sign-in page for Oracle Cloud Infrastructure (**Launch OCI** button)
- A username and password to sign in to the LiveLabs tenancy. When signing in for the first time, you are prompted to change your password.
- A compartment of your very own. We refer to this compartment as "your compartment" throughout the workshop. Make note of your compartment's name because you need to select it often throughout the workshop.
- An Autonomous Database in your compartment. You are provided the password for the `ADMIN` account on your database.

3. Make note of your username and click the **Copy Password** button for Oracle Cloud Infrastructure.

4. On the **Reservation Information** panel, click the **Launch OCI** button. Leave the default domain selected, and click **Next**.

A new browser tab is opened and the sign in page for the LiveLabs tenancy is displayed.

5. Enter your username (if needed) and paste the password into the **Password** box, and then click **Sign In**.

The **Change Password** page is displayed.

6. In the **Current Password** box, paste your password. In the **New Password** and **Confirm New Password** boxes, enter a new password. Note the password requirements, which are provided on the page. Click **Save New Password**.

You are now signed in to your LiveLabs Sandbox in Oracle Cloud Infrastructure.


## Task 2: Access Oracle Data Safe and view your registered target database

A database registered with Oracle Data Safe is referred to as a *target* database in Oracle Data Safe.

1. From the navigation menu, select **Oracle Database**, and then **Data Safe - Database Security**. The **Overview** page is displayed. If the **Welcome to Data Safe** tour dialog box is displayed, click **Stop tour**.

2. On the left, click **Target databases**.

3. Under **List scope**, make sure your compartment is selected. Your registered target database is listed on the right.

- A target database with an **Active** status means that it is currently registered with Oracle Data Safe.
- A target database with a **Deleted** status means that it is no longer registered with Oracle Data Safe. The listing is removed 45 days after the target database is deregistered.

![Target databases page in OCI](images/target-databases-page-oci.png "Target databases page in OCI")


## Task 3 (Optional): Explore Security Center

1. In the breadcrumb at the top of the page, click **Data Safe**.

The **Overview** page is displayed.

2. Under **Security center** on the left, click **Dashboard** and review the dashboard. Scroll down to view the security controls and feature metrics (charts). Make sure your compartment is selected under **List scope**. From the **Target databases** drop-down list, select your target database so that the data in the dashboard pertains to your target database only.

- In Security center, you can access all the Oracle Data Safe features, including the dashboard, Security Assessment, User Assessment, Data Discovery, Data Masking, Activity Auditing, SQL Firewall, and Alerts.
- When you register a target database, Oracle Data Safe automatically creates a security assessment and user assessment for you. That's why the **Security assessment**, **User assessment**, **Feature usage**, and **Operations summary** charts in the dashboard already have data.
- During registration, Oracle Data Safe also discovers audit trails on your target database. That's why the **Audit trails** chart in the dashboard shows one audit trail with the status **In transition** for your Autonomous Database. Later you start this audit trail to collect audit data into Oracle Data Safe.

![Initial Dashboard - security controls](images/dashboard-security-controls.png "Initial Dashboard - security controls")

![Initial Dashboard - feature metrics top half](images/feature-metrics-top-half.png "Initial Dashboard - feature metrics top half")

![Initial Dashboard - feature metrics bottom half](images/feature-metrics-bottom-half.png "Initial Dashboard - feature metrics bottom half")


## Task 4: Access Oracle Database Actions

Database Actions provides a way for you to run SQL commands on your database. The step-by-step instructions for accessing Database Actions are covered here. Subsequent labs simply say to "access the SQL worksheet in Database Actions." You can always refer back to these steps for help if needed.

1. From the navigation menu (hamburger menu in the upper-left corner), select **Oracle Database**, and then **Autonomous Transaction Processing**. Under **List Scope**, select your compartment under the **LiveLabs** folder. In the table on the right, click the name of your database.

2. At the top of the **Autonomous Database details** page, from the **Database actions** menu, select **SQL**.

3. If required, sign in as the `ADMIN` user.

- If a tenancy administrator provided you an Autonomous Database, obtain the password from that person.
- If you are using an Oracle-provided environment, enter the database password provided to you.

4. Close the **SQL History** and **Warning** dialog boxes.

5. Review the interface. Here are the ways that you use Database Actions during the workshop:

- In the **Navigator** pane on the left, you select tables from the **HCM1** schema on your database.
- On the **Worksheet** on the right, you run SQL commands and scripts.
- On the **Query Result** and **Script Output** tabs at the bottom of the page, you review query results and output generated from running scripts.

![SQL Worksheet in Oracle Database Actions](images/database-actions.png "SQL Worksheet in Oracle Database Actions")

6. *Leave the **SQL | Oracle Database Actions** tab open because you return to it throughout this workshop.* If your session expires, you can always sign in again.

7. Return to Oracle Data Safe: Click the **Autonomous Database | Oracle Cloud Infrastructure** browser tab. From the navigation menu, select **Oracle Database**, and then **Data Safe - Database Security**. The **Overview** page is displayed.


You may now **proceed to the next lab**.

## Learn More

- [Oracle Cloud Infrastructure documentation](https://docs.oracle.com/iaas/Content/home.htm)
- [OCI Cloud Free Tier](https://www.oracle.com/cloud/free/)
- [Target Database Registration](https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/data-safe&id=ADMDS-GUID-B5F255A7-07DD-4731-9FA5-668F7DD51AA6)
- [Oracle Data Safe Dashboard](https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/data-safe&id=ADMDS-GUID-B4D784B8-F3F7-4020-891D-49D709B9A302)



## Acknowledgements

- **Author** - Jody Glover, Consulting User Assistance Developer, Database Development
- **Last Updated By/Date** - Jody Glover, May 16, 2024
132 changes: 132 additions & 0 deletions data-safe/access-environment/access-environment-sandbox.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
# Access your environment

## Introduction

In this lab, you access and review your LiveLabs Sandbox environment in Oracle Cloud Infrastructure. Your environment comes with a tenancy, a compartment, an Oracle Cloud account in the LiveLabs tenancy, and a pre-provisioned Autonomous Database. Sample data is loaded into your database and your database is registered with Oracle Data Safe.

Estimated Lab Time: 5 minutes

### Objectives

In this lab, you will:

- View your LiveLabs reservation information and sign in
- Access Oracle Data Safe and view your registered target database
- Explore Security Center
- Access Oracle Database Actions


### Prerequisites

This lab assumes you have:

- Obtained an Oracle Cloud account and signed in to the Oracle Cloud Infrastructure Console at `https://cloud.oracle.com`


## Task 1: View your LiveLabs Sandbox reservation information and sign in

1. In the upper-left corner of the lab instructions page (this page), click the **View Login Info** link.

A **Reservation Information** panel is displayed.

2. Review the information. You are provided with the following in Oracle Cloud Infrastructure:

- Access to one of the LiveLab's tenancies
- A link that directs you to the sign-in page for Oracle Cloud Infrastructure (**Launch OCI** button)
- A username and password to sign in to the LiveLabs tenancy. When signing in for the first time, you are prompted to change your password.
- A compartment of your very own. We refer to this compartment as "your compartment" throughout the workshop. Make note of your compartment's name because you need to select it often throughout the workshop.
- An Autonomous Database in your compartment. You are provided the password for the `ADMIN` account on your database.

3. Make note of your username and click the **Copy Password** button for Oracle Cloud Infrastructure.

4. On the **Reservation Information** panel, click the **Launch OCI** button. Leave the default domain selected, and click **Next**.

A new browser tab is opened and the sign in page for the LiveLabs tenancy is displayed.

5. Enter your username (if needed) and paste the password into the **Password** box, and then click **Sign In**.

The **Change Password** page is displayed.

6. In the **Current Password** box, paste your password. In the **New Password** and **Confirm New Password** boxes, enter a new password. Note the password requirements, which are provided on the page. Click **Save New Password**.

You are now signed in to your LiveLabs Sandbox in Oracle Cloud Infrastructure.


## Task 2: Access Oracle Data Safe and view your registered target database

A database registered with Oracle Data Safe is referred to as a *target* database in Oracle Data Safe.

1. From the navigation menu, select **Oracle Database**, and then **Data Safe - Database Security**. The **Overview** page is displayed. If the **Welcome to Data Safe** tour dialog box is displayed, click **Stop tour**.

2. On the left, click **Target databases**.

3. Under **List scope**, make sure your compartment is selected. Your registered target database is listed on the right.

- A target database with an **Active** status means that it is currently registered with Oracle Data Safe.
- A target database with a **Deleted** status means that it is no longer registered with Oracle Data Safe. The listing is removed 45 days after the target database is deregistered.

![Target databases page in OCI](images/target-databases-page-oci.png "Target databases page in OCI")


## Task 3: Explore Security Center

1. In the breadcrumb at the top of the page, click **Data Safe**.

The **Overview** page is displayed.

2. Under **Security center** on the left, click **Dashboard** and review the dashboard. Scroll down to view the security controls and feature metrics (charts). Make sure your compartment is selected under **List scope**. From the **Target databases** drop-down list, select your target database so that the data in the dashboard pertains to your target database only.

- In Security center, you can access all the Oracle Data Safe features, including the dashboard, Security Assessment, User Assessment, Data Discovery, Data Masking, Activity Auditing, SQL Firewall, and Alerts.
- When you register a target database, Oracle Data Safe automatically creates a security assessment and user assessment for you. That's why the **Security assessment**, **User assessment**, **Feature usage**, and **Operations summary** charts in the dashboard already have data.
- During registration, Oracle Data Safe also discovers audit trails on your target database. That's why the **Audit trails** chart in the dashboard shows one audit trail with the status **In transition** for your Autonomous Database. Later you start this audit trail to collect audit data into Oracle Data Safe.

![Initial Dashboard - security controls](images/dashboard-security-controls.png "Initial Dashboard - security controls")

![Initial Dashboard - feature metrics top half](images/feature-metrics-top-half.png "Initial Dashboard - feature metrics top half")

![Initial Dashboard - feature metrics bottom half](images/feature-metrics-bottom-half.png "Initial Dashboard - feature metrics bottom half")


## Task 4: Access Oracle Database Actions

Database Actions provides a way for you to run SQL commands on your database. The step-by-step instructions for accessing Database Actions are covered here. Subsequent labs simply say to "access the SQL worksheet in Database Actions." You can always refer back to these steps for help if needed.

1. From the navigation menu (hamburger menu in the upper-left corner), select **Oracle Database**, and then **Autonomous Transaction Processing**. Under **List Scope**, select your compartment under the **LiveLabs** folder. In the table on the right, click the name of your database.

2. At the top of the **Autonomous Database details** page, from the **Database actions** menu, select **SQL**.

3. If required, sign in as the `ADMIN` user.

- If a tenancy administrator provided you an Autonomous Database, obtain the password from that person.
- If you are using an Oracle-provided environment, enter the database password provided to you.

4. Close the **SQL History** and **Warning** dialog boxes.

5. Review the interface. Here are the ways that you use Database Actions during the workshop:

- In the **Navigator** pane on the left, you select tables from the **HCM1** schema on your database.
- On the **Worksheet** on the right, you run SQL commands and scripts.
- On the **Query Result** and **Script Output** tabs at the bottom of the page, you review query results and output generated from running scripts.

![SQL Worksheet in Oracle Database Actions](images/database-actions.png "SQL Worksheet in Oracle Database Actions")

6. *Leave the **SQL | Oracle Database Actions** tab open because you return to it throughout this workshop.* If your session expires, you can always sign in again.

7. Return to Oracle Data Safe: Click the **Autonomous Database | Oracle Cloud Infrastructure** browser tab. From the navigation menu, select **Oracle Database**, and then **Data Safe - Database Security**. The **Overview** page is displayed.


You may now **proceed to the next lab**.

## Learn More

- [Oracle Cloud Infrastructure documentation](https://docs.oracle.com/iaas/Content/home.htm)
- [OCI Cloud Free Tier](https://www.oracle.com/cloud/free/)
- [Target Database Registration](https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/data-safe&id=ADMDS-GUID-B5F255A7-07DD-4731-9FA5-668F7DD51AA6)
- [Oracle Data Safe Dashboard](https://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/data-safe&id=ADMDS-GUID-B4D784B8-F3F7-4020-891D-49D709B9A302)



## Acknowledgements

- **Author** - Jody Glover, Consulting User Assistance Developer, Database Development
- **Last Updated By/Date** - Jody Glover, May 16, 2024
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.
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ In this lab, you will:
- View the latest security assessment for your target database
- Adjust the risk level of a risk finding
- Set the latest assessment as the baseline assessment
- Generate activity on the target database
- Create a risk on the target database
- Refresh the latest security assessment and analyze the results
- Compare your assessment with the baseline

Expand All @@ -28,8 +28,8 @@ In this lab, you will:
This lab assumes you have:

- Obtained an Oracle Cloud account and signed in to the Oracle Cloud Infrastructure Console
- Prepared your environment for this workshop (see [Prepare Your Environment](?lab=prepare-environment))
- Registered your target database with Oracle Data Safe (see [Register an Autonomous Database with Oracle Data Safe](?lab=register-autonomous-database))
- Access to or prepared an environment for this workshop
- Access to a registered target database


### Assumptions
Expand Down Expand Up @@ -155,7 +155,7 @@ A baseline assessment shows you data for all your target databases in a selected
![Security Assessment Baseline has been set message](images/sa-baseline-has-been-set-message.png "Security Assessment Baseline has been set message")


## Task 5: Generate activity on the target database
## Task 5: Create a risk on the target database

In this task, you issue a `GRANT` command on your target database so that later, when you refresh the latest security assessment, you can compare assessments.

Expand Down Expand Up @@ -225,4 +225,4 @@ In this task, you issue a `GRANT` command on your target database so that later,
## Acknowledgements
* **Author** - Jody Glover, Consulting User Assistance Developer, Database Development
* **Last Updated By/Date** - Jody Glover, April 25, 2024
* **Last Updated By/Date** - Jody Glover, May 16, 2024
8 changes: 4 additions & 4 deletions data-safe/assess-database-users/assess-database-users.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,9 +26,9 @@ In this lab, you will:
This lab assumes you have:

- Obtained an Oracle Cloud account and signed in to the Oracle Cloud Infrastructure Console
- Prepared your environment for this workshop (see [Prepare Your Environment](?lab=prepare-environment))
- Registered your target database with Oracle Data Safe (see [Register an Autonomous Database with Oracle Data Safe](?lab=register-autonomous-database))
- (Optional) Started audit data collection for your target database in Oracle Data Safe (see [Audit Database Activity](?lab=audit-database-activity)). Audit data collection is required if you want to view users' audit records from within User Assessment.
- Access to or prepared an environment for this workshop
- Access to a registered target database
- (Optional) Started audit data collection for your target database in Oracle Data Safe. Audit data collection is required if you want to view users' audit records from within User Assessment.


### Assumptions
Expand Down Expand Up @@ -221,4 +221,4 @@ You can select a user assessment to compare with the latest user assessment. Wit
## Acknowledgements
* **Author** - Jody Glover, Consulting User Assistance Developer, Database Development
* **Last Updated By/Date** - Jody Glover, February 12, 2024
* **Last Updated By/Date** - Jody Glover, May 16, 2024
6 changes: 3 additions & 3 deletions data-safe/audit-database-activity/audit-database-activity.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,8 @@ This lab assumes you have:

- Obtained an Oracle Cloud account
- Signed in to the Oracle Cloud Infrastructure Console
- Prepared your environment for this workshop (see [Prepare Your Environment](?lab=prepare-environment))
- Registered your target database with Oracle Data Safe (see [Register an Autonomous Database with Oracle Data Safe](?lab=register-autonomous-database))
- Prepared your environment for this workshop
- Registered your target database with Oracle Data Safe


### Assumptions
Expand Down Expand Up @@ -444,4 +444,4 @@ You may now **proceed to the next lab**.
## Acknowledgements
* **Author** - Jody Glover, Consulting User Assistance Developer, Database Development
* **Last Updated By/Date** - Jody Glover, February 12, 2024
* **Last Updated By/Date** - Jody Glover, May 16, 2024
Loading

0 comments on commit a4da832

Please sign in to comment.