Create a Policy Studio project

A Policy Studio project is a design-time store of API Gateway configuration on a local file system, which can be deployed to a running API Gateway instance on a server.

6 minute read

You can create a new Policy Studio project from the following starting points:

  • Template configuration (for example, factory)
  • Deployment package (.fed file or .tar.gz file)
  • Policy and environment packages (.pol and .env files)
  • API Gateway instance
  • Existing API Gateway configuration

Launch the New Project wizard

To launch the New Project wizard in Policy Studio, select File > New Project in the main menu. Alternatively, click New Project on the welcome page.

Enter project details

Enter the following in the Project Details screen:

  • Name: Enter the Policy Studio project name. This field is required.
  • Use default location: Select whether to use the default location. This is selected by default.
  • Location: Enter or browse to the project location (for example, C:\Users\jane\apiprojects\my_test_project). When Use default location is selected, the default location is ${user.home}/apiprojects/${project.name}.

Click Next.

Select a project starting point

Select one of the following in the Project starting point window:

  • From a YAML template configuration
  • From an XML template configuration
  • From a .tar.gz file (YAML)
  • From a .fed file
  • From .pol and .env files
  • From an API Gateway instance
  • From existing configuration

New project from a YAML template configuration

To create a new project based on template configuration:

  1. Select the configuration template to use as a starting point:

    • Factory Template: Blank template that contains default factory configuration.
    • Factory Template with samples: Blank template that contains sample policies and other entities. This is for creating a project used for demo purposes.
  2. Click Finish.

New project from an XML template configuration

To create a new project based on template configuration:

  1. Select the configuration template to use as a starting point:

    • Factory Template: Blank template that contains default factory configuration.
    • Factory Template with samples: Blank template that contains sample policies and other entities. This is for creating a project used for demo purposes.
    • Team Development – Common Project (with Server Settings): Blank template that contains Server Settings. This is for creating your common project only. This should include policies common to multiple API projects (for example, authentication and authorization). Your API Gateway configuration must contain only one project with Server Settings. All other projects must have no Server Settings.
    • Team Development – API Project (without Server Settings): Blank template that does not contain Server Settings. This is for creating all your projects (except your common project). Your API Gateway configuration must contain only one project with Server Settings. All other projects must have no Server Settings.

    The team development templates are only available if team development is enabled in Policy Studio.

  2. Click Finish.

New project from a .fed file

To create a new project based on a deployment package (.fed file):

  1. Configure the following:
    • File: Enter or browse to the location of an API Gateway deployment package (.fed file).
    • Passphrase: Enter the encryption passphrase for the .fed file if one has been configured.
  2. Click Finish.

New project from a .tar.gz file (YAML)

To create a new project based on a deployment archive (.tar.gz file):

  1. Configure the following:
    • File: Enter or browse to the location of an API Gateway deployment archive (.tar.gz file).
    • Passphrase: Enter the encryption passphrase for the .tar.gz file if one has been configured.
  2. Click Finish.

New project from a policy package (.pol) file

To create a new project based on a policy package (.pol file):

  1. Configure the following:
    • Policy Package: Enter or browse to the location of an API Gateway policy package (.pol file). This is required.
    • Environment Package: Enter or browse to the location of an API Gateway environment package (.env file). This is optional.
    • Passphrase: Enter the encryption passphrase if one has been configured.
    • Advanced: Click to expand, and select whether to Allow unresolved references in policy package. This setting is optional.
  2. Click Finish.

New project from an API Gateway instance

To create a new project based on an API Gateway instance:

  1. In the Saved Sessions section, select the server session to use from the list. You can edit a session name by entering a new name and clicking Save. You can also click the appropriate button to Add, Clone, or Remove saved sessions.
  2. In the Connection Details section, configure the following:
    • Host: Enter the server host to connect to. The default is localhost.
    • Port: Enter the port to connect on. The default Admin Node Manager port is 8090.
    • User name: The deployment service is protected by HTTP basic authentication. Enter the administrator user name to use to authenticate to the server.
    • Password: Enter the password for the administrator user.
  3. Click Advanced to enter the URL of the deployment service exposed by the server. This setting is optional. The default Admin Node Manager URL is https://localhost:8090/api.
  4. Click Next to download the configuration from the server instance. If advisory warnings are configured, you must click Next again before downloading the configuration.
  5. Configure the following in the Make a server connection window:
    • Group: Select the API Gateway group from the list (for example, QuickStart Group), and select the server instance in the panel below (for example, QuickStart Server).
    • Passphrase: Enter the API Gateway passphrase if one has been configured.
  6. Click Finish.

New project from existing configuration

To create a new project based on an existing configuration directory:

  1. Configure the following:
    • File: Enter or browse to the location of the configuration directory (for example, INSTALL_DIR\apigateway\conf\fed is the Admin Node Manager configuration directory).
    • Passphrase: Enter the encryption passphrase if one has been configured.
  2. Click Finish.

Create API Manager projects

To create a project with API Manager configuration, perform the following steps:

  1. Create a new project using any of the options detailed in Select a project starting point.

  2. Select File > Configure API Manager. For more details on configuring API Manager in Policy Studio, see the Enable API Manager.

    Alternatively, if you already have API Manager configured you can create the project from the existing API Gateway configuration directory.

Automatic upgrade of project configuration from earlier versions

If you create a project from a .fed file, a .pol file, or a configuration directory from an earlier API Gateway version, the configuration is automatically upgraded to the current version when the new project is created. The configuration directory can be from an API Gateway instance, Admin Node Manager, or API Gateway Analytics.

Upgrade of project after 7.7 One Version update

After applying API Gateway One Version update to Policy Studio, it is not required to import old projects into the new Policy Studio. Instead, when you open a project after the update, an option to automatically upgrade the project is shown.