Oracle® Fusion Middleware
Part 4. General Configuration

You can use the Policy Studio to manage API Gateway, Admin Node Manager, and API Gateway Analytics servers. The Open Connection dialog enables you to connect to a server URL, and the Open File dialog enables you to connect to a server configuration file (.xml) or deployment archive (.fed) . By default, the Policy Studio connects to a server URL. This topic describes how to connect using a server URL, configuration file, or deployment archive.

The server exposes a deployment service to its underlying configuration data. This enables Policy Studios running on different machines to that on which the server is installed to manage policies remotely. To connect to the deployment service of a running server, select File > Connect to server from the main menu, or the equivalent button in the toolbar. Configure the following fields on the Open Connection dialog:

Saved Sessions:

Select the session that you wish to use from the drop-down list. You can edit a session name by entering a new name and clicking Save. You can also add or remove saved sessions using the appropriate button.

Connection Details

The Connection Details section enables you to specify the following settings:

Host:

Specify the host to connect to in this field. The default is localhost.

Port:

Specify the port to connect on in this field. The default Admin Node Manager port is 8090.

Use SSL:

Specify whether to connect securely over SSL. This is selected by default.

User Name:

The deployment service is protected by HTTP Basic authentication. You must provide a user name and password so that the Policy Studio can authenticate to the server. By default, the server User Store contains an admin user with a changeme password, which can be used in this case. You can change this user's details using the Authentication repository interface.

Password:

Specify the password for the user. The password for the default admin user is changeme.

Advanced

Click Advanced to specify the following setting:

URL:

Enter the URL of the deployment service exposed by the server. For example, the default Admin Node Manager URL is https://localhost:8090/api, where HOST points to the IP address or host name of the machine on which the API Gateway is running.

Because the server configuration data is stored in XML files, you can specify that the Policy Studio connects directly to a file. You can connect to a server configuration file (.xml) or a deployment archive (.fed). For more details, see Deploy API Gateway configuration.

To connect to a file, select File > Open file from the main menu, or click the Open file link on the welcome page. Complete the following fields on the Open File dialog:

File:

Enter or browse to the location of a server configuration file (for example, INSTALL_DIR\groups\group-2\conf\378fd412-4e14-4924-b666-b974adf19642\configs.xml). Alternatively, enter or browse to the location of a deployment archive (.fed).

Passphrase Key:

All sensitive server configuration data (password, keys, and so on) can be encrypted using a passphrase. If you wish to do this, enter a password in this field when connecting. You must use this password thereafter when connecting to the server.

You can also use the Open File dialog to unlock a connection to a server. This is for emergency use when you have changed configuration that results in you being locked out from the Management Services on port 8090. In this case, you have misconfigured the authentication filter in the Protect Management Interfaces policy. For example, if you created and deployed an LDAP connection without specifying the correct associated user accounts, and are now unable to connect to the Admin Node Manager.

To unlock a server connection, perform the following steps:

For more details on Management Services, see Policy Studio preferences.