9 Set Up Delivery Destinations

This topic describes the setup required to deliver reports. It also describes how to set up the HTTP notification server.

Add a WebDAV Server

You add a WebDAV server from the Administration page.

To add a WebDAV server:

  1. From the Administration page, select WebDAV to display the list of servers that have been added. Select Add Server.
  2. Enter the Name and Host for the new server.
  3. Optionally enter the following fields if appropriate:
    • General fields — Port

    • Security fields — Authentication Type (None, Basic, Digest) and Encryption Type (None, SSL).

    • Proxy Server fields — Host, Port, User Name, Password, Authentication Type (None, Basic, Digest)

Add an Object Storage

You can use one or more Object Storages to deliver and store reports.

You can configure an Object Storage as a delivery channel, and schedule jobs to deliver reports to the Object Storage.

Make sure you have the permissions to access a compartment in Oracle Cloud Infrastructure Object Storage where you can create a bucket to organize your reports.

Even if you have administrator access to the Object Storage, you should have the permissions to configure the connection and to deliver reports to Object storage. An administrator in your organization must set up the permissions in Oracle Cloud Infrastructure using IAM policies to enable you to deliver files from Publisher to Object Storages. See Getting Started with Policies and Policy Reference.

  • Permissions required for tenancy:

    • COMPARTMENT_INSPECT
    • OBJECTSTORAGE_NAMESPACE_READ
  • Permissions required for compartment mangement:

    • BUCKET_READ
    • BUCKET_INSPECT
    • OBJECT_READ OBJECT_OVERWRITE
    • OBJECT_CREATE
    • OBJECT_DELETE
    • OBJECT_INSPECT
  1. Use the Oracle Cloud Infrastructure console to create a Bucket in the Object Storage, and then set up the API key for authentication.
    Make sure you gather the user details, tenancy details, and the Public Key Fingerprint value of the SSH key so that you can configure the Object Storage in Publisher. See the Oracle Cloud Infrastructure documentation for detailed steps.
  2. In Publisher, upload the private key file for the Object Storage to the server, and add the Object Storage as a delivery channel.
    1. From the Administration page, under Delivery, select Object Storage, and then click Add Server.
      1. In the Server Name field, type a name for the server. For example, objectstorage1.
      2. In the URI field, type the URL of the Object Storage. For example, https://objectstorage.us-ashburn-1.oraclecloud.com.
      3. In the Tenancy OCID and User OCID fields, provide the credentials for accessing the Object Storage.
      4. Copy the public key fingerprint value of the Object Storage from the Oracle Cloud Infrastructure console, and paste it in the Public Key Fingerprint field.
      5. Specify the private key file and enter the private key password.

        In the Private Key File field, type the full path of the private key file stored in the server. For example, /security/privatekeys/objectstorae/oci_api_key.ppm.

      6. Specify the compartment provisioned for your tenancy and the Bucket associated with your compartment where you want to deliver the reports.
      7. In the Access Control section, deselect Public.
      8. From the Available Roles list, select one or more roles you want to provide access to the delivery channel, and click Move to add them to the Allowed Roles list.
      9. Click Test Connection.
      10. Click Apply.

Example 9-1 Policy Configuration

Sample policy configuration to allow group g to inspect the compartments in tenancy:

Allow group <g> to inspect compartments in tenancy

Sample policy configuration to allow group g to manage the Object Storage in tenancy:

Allow group <g> to manage objectstorage-namespaces in tenancy

Sample policy configuration to allow group g to manage compartment c and perform the requested operations in the compartment:

Allow group <g> to manage object-family in compartment <c> where any {
request.operation=‘ListBuckets’,
request.operation=‘ListObjects’,
request.operation=‘PutObject’,
request.operation=‘GetObject’,
request.operation=‘CreateMultipartUpload’,
request.operation=‘UploadPart’,
request.operation=‘CommitMultipartUpload’,
request.operation=‘AbortMultipartUpload’,
request.operation=‘ListMultipartUploads’,
request.operation=‘ListMultipartUploadParts’,
request.operation=‘HeadObject’,
request.operation=‘DeleteObject’}