setIPAllowlist (Deprecated)

Configures an allowlist of IP addresses and Classless Inter-Domain Routings (CIDRs) that are permitted to access Oracle Fusion Cloud Enterprise Performance Management. This command adds or removes IPv4 addresses and CIDRs.

Note:

This command is deprecated and will be removed in a future update. Instead of using this command, set up a Network Perimeter in Oracle Identity Cloud Service to limit sign-ins to specific IP addresses or ranges for the whole domain. See these information sources:

• Setting up Network Perimeter in Getting Started Guide for Administrators
• Manage Oracle Identity Cloud Service Network Perimeters in Administering Oracle Identity Cloud Service

Note:

• When you setup IP allowlist for a Cloud EPM environment, you permit connections only from those specific IP addresses. In this scenario, requesting access from another Cloud EPM will not work unless you add the outbound IP addresses of the region where the requesting environment is located to the IP allowlist. See Outbound IP Addresses of Cloud EPM Data Centers and Regions in the Operations Guide for the IP addresses that you need to add to ensure that the other environments can communicate with the environment for which the IP allowlist is being set up.
• If you are using IDCS Network Perimeter in the Identity Cloud service where the environment is located, you must add the same IP addresses in this Network Perimeter as well.

Applies to

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Oracle Fusion Cloud Enterprise Data Management, Narrative Reporting, Sales Planning, and Strategic Workforce Planning.

Required Roles

Service Administrator

Usage

epmAutomate setIPAllowlist add|remove FILE_NAME.txt where:

• add adds the IP addresses and CIDRs listed in a text file to the allowlist.
• remove deletes the IP addresses and CIDRs listed in a text file from the allowlist.
• FILE_NAME is the name of a text file listing the IP addresses and CIDRs to be added to or removed from the allowlist. Each entry in the file must be separated by a newline character. Use the uploadFile command to upload this file to the environment. Each line in the file must be an IPv4 address or CIDR in the following format:

  xxx.xxx.xxx.xxx
  xxx.xxx.xxx.xxx/n
  

  Note:

  • Only IPv4 IP addresses are supported.
  • Use CIDR format, rather than individual IP addresses, to specify a continuous range of IP addresses.
  • To disable an allowlist to permit access from any IP address, use the getIPAllowlist (Deprecated) command to write all existing IP addresses and CIDRs to a file. Upload the file to the environment, and then run this command with the remove option as shown in this example:

    epmAutomate getIPAllowlist > myRemoveList.txt
    epmAutomate uploadFile myRemoveList.txt
    epmAutomate setIPAllowlist remove myRemoveList.txt
    

Examples

• Adding some IP addresses and CIDRs to an allowlist:

  epmAutomate setIPAllowlist add myAddList.txt

• Removing some IP addresses from an allowlist:

  epmAutomate setIPAllowlist remove myRemoveList1.txt