Tuesday, August 11, 2020

OIC Gen2 File Server

File Server - OIC Generation 2 Feature

File Server provides an embedded SFTP server within Oracle Integration, enabling organizations to focus on building integrations without needing to host and maintain a separate SFTP server.

Inbuilt OIC File server instance provides 500 GB of storage and is available on both Generation 2 Standard and Enterprise Editions .

The primary users of File Server include:
  • Oracle Integration administrators.
  • Oracle Integration developers.
  • Oracle Integration users.
  • File Server REST APIs.
Oracle Integration administrators, who use File Server to manage server settings and configure users, groups and folders, including permissions.
Note: You must be assigned the ServiceAdministrator role in Oracle Integration. 

Oracle Integration developers, who use File Server along with the FTP adapter in integrations to read and write files.

Oracle Integration users, who access File Server using an SFTP client. These users must be configured and enabled as users in File Server. Their access is controlled by their assigned folders and folder permissions.

File Server REST APIs, APIs are provided for File Server administration.
https://docs.oracle.com/en/cloud/paas/integration-cloud/rest-api-fs/rest-endpoints.html

How to Enable File Server


To begin using File Server in Oracle Integration, it must first be enabled for the Oracle Integration instance in the Oracle Cloud Infrastructure Console. Enabling File Server is a one-time activity.
  1. Select your instance in the Oracle Cloud Infrastructure Console.
  2. Click the Enable link for File Server on the Integration Instance Information tab



File Server Settings

We can use the Settings page on OIC console to monitor File Server’s overall health and change its main settings.
On Oracle Integration Home page, choose Settings -> File Server -> Settings.
Under Status settings, monitor the server's status, and stop or restart as needed.




Under Security, we can modify the authentication type which can be

  • Password
  • ssh key based
  • or both




Configure Users and Groups
We can use the Users page to enable SFTP access for selected users and groups, upload a public key for a user, and specify the user or group's folder type.
  • In Oracle Identity Cloud Service, create users or groups whom you want to enable as SFTP users to access File Server. Once added, you can enable their access to File Server.
  • Hover over a row and click Edit Configuration . A user side pane is displayed, where you can upload your Public key if key based security is configured on settings page. Also you can specify the Home folder for the specified user.


Configure Folders

Use the Folders page to create and manage folders and set their permissions. A user’s permissions are a combination of individual assigned permissions and those of any groups the user is a member of. 

Once folders are configured, users with the appropriate permissions can add files to folders using an external SFTP client.


Click a folder's Permissions icon. The Folders Permissions page is displayed, showing a list of users or groups with permissions configured for the current folder.

FAQ

Cost/Billing:

There are no extra cost associated with File Server.

However while using to FTP adapter to read/write files from/to OIC File Server, the standard pricing of FTP adapter applies.

Any file read or write 50kb will be a considered a message. Any message over 50KB in size must be counted as multiple messages, with each 50KB or portion thereof counting as equivalent to one message (e.g., 210KB would be counted as 5 messages).

 

What is the total amount of storage allowed?

Each File Server service instance provides 500 GB of free storage. We can’t increase the storage size.

 

What is the size limit on files uploaded or downloaded?

File size is not limited when uploading or downloading files from an SFTP client, although it is subject to allocated storage limits.

In integrations, inline message payloads (such an XML string or a JSON string) are limited to 10MB, and files and attachments (such as SOAP attachments) can be up to 1GB.

 

What encryption options are available when reading files from and writing files to File Server?

When accessing files from OIC File Server, you can leverage the encryption/decryption features supported by the FTP Adapter. The FTP Adapter supports Pretty Good Privacy (PGP) encryption, which:

·Enables you to encrypt a file that is being uploaded to remote FTP/SFTP servers using Pretty Good Privacy (PGP) cryptography.
·Enables you to decrypt a file that is being read or downloaded from a remote FTP/SFTP server using Pretty Good Privacy (PGP) cryptography.

 

In Latest OIC versions, we can also use Stage Action to encrypt/decrypt the files.

1 comment: