*This page
applies to **Apigee** and **Apigee hybrid**.*


Apigee Advanced API Security is available as an additional add-on for your API hub instance to help you manage and govern the security posture of your APIs across multiple Apigee organizations, environments, and gateways. Leveraging API hub's [plugins](https://docs.cloud.google.com/apigee/docs/apihub/plugins.md.txt) and [curation](https://docs.cloud.google.com/apigee/docs/apihub/curations.md.txt) capabilities, Advanced API Security offers an unified view that lets you monitor risks, compare configurations, and ensure consistent security standards across your entire API ecosystem.

## Key capabilities


Advanced API Security offers the following capabilities when you enable it for your API hub instance:

- **Risk assessment across multiple Apigee organizations, environments, and gateways:** assess the security scores for a specific API or for all APIs across all of its deployments in multiple Apigee organizations, environments, and gateways to get a comprehensive understanding of its risk profile.
  - To learn about viewing security scores across multiple Apigee organizations, environments, and gateways, see [View security scores across multiple Apigee organizations and gateways](https://docs.cloud.google.com/apigee/docs/apihub/view-security-scores-multi-gateway.md.txt).
  - To learn about viewing security scores for a specific API across its deployments, see [View security scores for APIs](https://docs.cloud.google.com/apigee/docs/apihub/view-api-security-scores.md.txt).
- **Security profiles:** create and manage custom security profiles based on your organization's needs, and apply them consistently across your multiple Apigee environments, organizations, and gateways.
  - To learn about creating and managing security profiles for multiple Apigee organizations and gateways, see [Manage security profiles for multiple Apigee organizations and gateways](https://docs.cloud.google.com/apigee/docs/apihub/manage-security-profiles-multi-gateway.md.txt).
- **Monitoring conditions and alerts:** track and analyze the security posture of your API deployments over time, using [Cloud Monitoring](https://docs.cloud.google.com/monitoring/docs/monitoring-overview.md.txt). Add alerts to notify you when the security posture changes.
  - To learn about managing security monitoring conditions and alerts, see [Manage monitoring conditions for multiple Apigee organizations and gateways](https://docs.cloud.google.com/apigee/docs/apihub/manage-monitoring-conditions-multi-gateway.md.txt).

## Enable Advanced API Security for your API hub instance


To enable and configure Advanced API Security for your API hub instance, see [Configure Advanced API Security for multiple Apigee organizations and gateways](https://docs.cloud.google.com/apigee/docs/apihub/configure-advanced-api-security-multi-gateway.md.txt).

> [!CAUTION]
> **Caution:** Pricing for Advanced API Security varies based on your existing Apigee organization license type. We recommend that you use the [Advanced API Security advisor tool](https://docs.cloud.google.com/apigee/docs/apihub/advanced-api-security-advisor.md.txt) to understand your costs before enabling the add-on in your API hub instance.

## IAM roles and permissions


To use Advanced API Security, you must have the following IAM roles and permissions:

| IAM roles | Permissions | Description |
|---|---|---|
| **API Security Admin** (`roles/apigee.securityAdmin`) | - apigee.securityProfilesV2.create - apigee.securityProfilesV2.delete - apigee.securityProfilesV2.update - apigee.securityProfilesV2.get - apigee.securityProfilesV2.list | Provides permissions to create, update, delete, get, and list security profiles. |
| **API Security Admin** (`roles/apigee.securityAdmin`) | - apigee.securityAssessmentResult.compute | Provides permissions to compute security assessment results. |
| **API Security Admin** (`roles/apigee.securityAdmin`) | - apigee.securityMonitoringConditions.create - apigee.securityMonitoringConditions.delete - apigee.securityMonitoringConditions.get - apigee.securityMonitoringConditions.list - apigee.securityMonitoringConditions.update | Provides permissions to create, delete, get, list, and update security monitoring conditions. |
| **API Security Viewer** (`roles/apigee.securityViewer`) | - apigee.securityProfilesV2.get - apigee.securityProfilesV2.list | Provides permissions to get, list, and view security profiles. |
| **API Security Viewer** (`roles/apigee.securityViewer`) | - apigee.securityAssessmentResult.compute | Provides permissions to compute security assessment results. |
| **API Security Viewer** (`roles/apigee.securityViewer`) | - apigee.securityMonitoringConditions.get - apigee.securityMonitoringConditions.list | Provides permissions to get and list security monitoring conditions. |
| **API hub Admin** (`roles/apihub.admin`) or **API hub Add-on Admin** (`roles/apihub.addonsAdmin`) | - apihub.addons.get - apihub.addons.list - apihub.addons.manage | Provides permissions to manage add-ons in API hub. |
| **API hub Admin** (`roles/apihub.admin`) or **API hub Add-on Admin** (`roles/apihub.addonsAdmin`) | - apihub.apis.get - apihub.deployments.list | Provides permissions to get and list APIs and deployments in API hub. |
| **API hub Viewer** (`roles/apihub.viewer`) | - apihub.addons.get - apihub.addons.list | Provides permissions to get and list add-ons in API hub. |
| **API hub Viewer** (`roles/apihub.viewer`) | - apihub.apis.get - apihub.deployments.list | Provides permissions to get and list APIs and deployments in API hub. |

To configure and use security monitoring conditions and alerts in Cloud Monitoring:

| Action(s) | Required roles or steps |
|---|---|
| List and view security monitoring condition metrics | [Monitoring Admin](https://docs.cloud.google.com/monitoring/access-control.md.txt#monitoring.admin) (`roles/monitoring.admin`) [Monitoring Editor](https://docs.cloud.google.com/monitoring/access-control.md.txt#monitoring.editor) (`roles/monitoring.editor`) |
| Create, update, or delete monitoring alerts | See [Required roles (for security alerts)](https://docs.cloud.google.com/apigee/docs/api-security/security-alerts.md.txt#required-roles) |
| View monitoring alerts | See [Incidents for metric-based alerting policies: Before you begin](https://docs.cloud.google.com/monitoring/alerts/incidents-events.md.txt#before-you-begin) |


For information about granting IAM roles, see [Grant or revoke multiple IAM roles using the Google Cloud console](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt#multiple-roles-console).

## What's next

- To enable Advanced API Security for your API hub instance, see [Configure Advanced API Security for multiple Apigee organizations and gateways](https://docs.cloud.google.com/apigee/docs/apihub/configure-advanced-api-security-multi-gateway.md.txt).
- To view security scores across multiple Apigee organizations and gateways, see [View security scores across multiple Apigee organizations and gateways](https://docs.cloud.google.com/apigee/docs/apihub/view-security-scores-multi-gateway.md.txt).
- To view security scores for a given API across its deployments in gateways, see [View security scores for APIs](https://docs.cloud.google.com/apigee/docs/apihub/view-api-security-scores.md.txt).
- To manage security profiles across multiple Apigee organizations and gateways, see [Manage security profiles for multiple Apigee organizations and gateways](https://docs.cloud.google.com/apigee/docs/apihub/manage-security-profiles-multi-gateway.md.txt).
- To learn enabling Apigee Advanced API Security from your Apigee X/hybrid instance, see [Apigee Advanced API Security](https://docs.cloud.google.com/apigee/docs/api-security.md.txt).