It seems like your browser didn't download the required fonts. Please revise your security settings and try again.
Barracuda CloudGen Firewall

This Firmware Version Is End-Of-Support

Documentation for this product is no longer updated. Please see End-of-Support for CloudGen Firewall Firmware for further information on our EoS policy.

How to Create a CC Admin to Access the REST API

  • Last updated on

To use the REST API, each call must be authenticated. For Control Center-managed firewalls, create a dedicated CC admin user and administrative role to allow REST API access. In the administrative role, you can differentiate between the internal and external interface and even grant write permissions to the REST API. 

Step 1. Create a Custom Administrative Role

  1. Go to CONFIGURATION > Configuration Tree > Multi-Range > Global Settings > Administrative Roles.
  2. Click Lock.
  3. In the Roles section, click + to create a new role.
  4. Enter a Name for the role and click OK. The Roles configuration window opens.

  5. Add the REST API access rights to the administrative role:

    1. Select the Access to REST API check box. 

    2. Click Set/ Edit to configure detailed permissions.

    3. Configure the access rights:

      • Internal API Access – Provides access to the complete REST API interface.
      • External API Access – Provides access to the REST API sub-interface.

        Currently, all REST API calls are present in both the internal and external interfaces.  

      • Write Access – Provides write access on the selected interface.
    4. Click OK.

  6. Click OK.
  7. Click Send Changes and Activate.

Step 2. Create an Admin Account

Add an administrator account, configure authentication settings, and assign the administrative role to the account.

  1. Go to ADMINS.
  2. Click New Entry.
  3. Enter a Name for the account. This is the user login name.
  4. From the Range list, select which ranges the admin should be able to access. 
  5. From the Cluster list, select which clusters that the admin can access.
  6. Click OK . The Administrator configuration window opens.
  7. For local authentication, configure username and password:
    • Login Name – Enter the username for the REST API CC admin. 
    • Full Name – Enter the full name. 
    • Password – Enter the password.
    • External Authentication – Select Local (No external Authentication).
  8. Assign the administrative role:
    • Configuration Level – Set to 0 to allow write access. 
    • Roles – Select the role created in step 1 and click Add.
    • Shell Level – Select No Access
  9. (optional) Change Login Event to a less verbose setting.
  10. Click OK.
  11. Click Activate.

The CC admin user you just created can now access the REST API interface for the ranges and clusters assigned to the user.

Last updated on