OIC provides us option to leverage the embedded file server as any other SFTP we usually use in our integrations using FTP adapter.
It provides 500 GB of space.
There are multiple steps that need to be performed as part of enabling and configuring the OIC embedded file server.
1)Enable the file server for your OIC instance
2) Have appropriate roles for admin,developer and user
3) Configure the file server- configure folder and permissions,configure and enable users, configure security and other policy.
1) Enable the file server for your OIC instance
If we login to OIC instance and if you select File Server from the navigation pane and if
it's not yet enabled for our Oracle Integration Instance, the following message appears:
So we need to enable the file server for this instance:
Enabling File Server is a one time action
Login to Oracle Cloud Infrastructure Console, and click on menu button.
Select the respective compartment and then the respective OIC instance where we want to enable the File Server.
We can see in above screenshot that file server is not enabled.
Click on enable. A prompt window appears.
Click on enable here to enable the File server for this OIC instance.
The OIC icon turns orange and its status changes to Updating.
After few minutes it turns to green again and we can see that the file server is enabled now.
Now our file server is enabled. If we login to OIC instance console and navigate to file server, we will see like below.
Now we will configure File server here.
Before this we will see what different roles will be required to administer and use the file server.
2) Have appropriate roles for admin,developer and user
- Oracle Integration administrators, who use File Server to manage server settings and configure users, groups, and folders, including permissions. To administer File Server, we 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.
security and other policy.
If we expand default home folders for user and group we see the default permissions, we can customize it.
Under security we have many options like authentication type, zipping, signature algorithm etc.
We will make authentication type as only password for now. We have option to keep key, password and password or key.
Now click on users and search for the user you want to configure and enable:
We can see that this user is not configured and enabled yet. Click on the expand icon on present on the rightmost to see details of this user.
Click on pencil icon to configure this user.
If we would have had key based authentication then we had to upload the SSH public key here.
Since we have enable authentication type as only password so it is not required to upload key right now.
See the default home folder for this user. Click on cross icon (X) to save the configuration
After this we can see that the user is configured and enabled.
Now click on Files and navigate to to home folder of integration user which we have configured in the previous step.
$root/home/users/integrationuser/
We can see that there is no file.
We can create new folders as well under the home directory.
Now we will login to this SFTP file server using IP, Post and username password through any SFTP client like FileZilla
Create new site, enter the details and click on connect.
After it is connected , it will list the directory and show the content in home directory.
We can see that currently there are no files in the home directory for this user.
Now we will login to OIC console to verify if the file has been uploaded to OIC file server.
We can see that the file is uploaded to OIC file server.
In the next post we will see how we can use this file server in creating connection using FTP adapter and use in our integration flow.
