Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
As a user of firmware analysis, you may want to manage access to your firmware image analysis results. Azure Role-Based Access Control (RBAC) is an authorization system that enables you to control who has access to your analysis results, what permissions they have, and at what level of the resource hierarchy. This article explains how to store firmware analysis results in Azure, manage access permissions, and use RBAC to share these results within your organization and with third parties. To learn more about Azure RBAC, visit What is Azure Role-Based Access Control (Azure RBAC)?.
Roles
Roles are a collection of permissions packaged together. There are two types of roles:
- Job function roles give users permission to perform specific job functions or tasks, such as Key Vault Contributor or Azure Kubernetes Service Cluster Monitoring User.
- Privileged administrator roles give elevated access privileges, such as Owner, Contributor, or User Access Administrator. To learn more about roles, visit Azure built-in roles.
In firmware analysis, the most common roles are Owner, Contributor, Security Admin, and Firmware Analysis Admin. Learn more about which roles you need for different permissions, such as uploading firmware images or sharing firmware analysis results.
Understanding the Representation of Firmware Images in the Azure Resource Hierarchy
Azure organizes resources into resource hierarchies, which are in a top-down structure, and you can assign roles at each level of the hierarchy. The level at which you assign a role is the "scope," and lower scopes may inherit roles assigned at higher scopes. Learn more about the levels of hierarchy and how to organize your resources in the hierarchy.
When you onboard your subscription to firmware analysis, you'll be asked to create a workspace. A workspace is a resource specific to the firmware analysis service that directly houses your firmware images. You can create multiple workspaces in each resource group, which allows you to organize your firmware images into categories at the resource group level, and subcategories at the workspace level.
Navigate to your resource group. Notice that all workspace resources have the Firmware analysis workspace type.
As mentioned earlier, the workspace resource directly holds your firmware images, so you may regularly interact with your workspaces depending on how you organize your images. Each firmware image that you upload will be represented as a resource and stored here.
You can use RBAC at each level of the hierarchy, including at the workspace resource level.
Here's the resource hierarchy of firmware analysis:
Apply Azure RBAC
Note
To begin using firmware analysis, the user that onboards the subscription onto firmware analysis must be an Owner, Contributor, Firmware Analysis Admin, or Security Admin at the subscription level. Follow the tutorial at Analyze a firmware image with firmware analysis to onboard your subscription. Once you've onboarded your subscription, a user only needs to be a Firmware Analysis Admin to use firmware analysis.
As a user of firmware analysis, you may need to perform certain actions for your organization, such as uploading firmware images or sharing analysis results.
Actions like these involve Role-Based Access Control (RBAC). To effectively use RBAC for firmware analysis, you must know what your role assignment is, and at what scope. Knowing this information will inform you about what permissions you have, and thus whether you can complete certain actions. To check your role assignment, refer to Check access for a user to a single Azure resource - Azure RBAC. Next, see the following table to check what roles and scopes are necessary for certain actions.
Common roles in firmware analysis
This table categorizes each role and provides a brief description of their permissions:
Role | Category | Description |
---|---|---|
Owner | Privileged administrator role | Grants full access to manage all resources, including the ability to assign roles in Azure RBAC. |
Contributor | Privileged administrator role | Grants full access to manage all resources, but doesn't allow you to assign roles in Azure RBAC, manage assignments in Azure Blueprints, or share image galleries. |
Security Admin | Job function role | Allows the user to upload and analyze firmware images, add/assign security initiatives, and edit the security policy. Learn more. |
Firmware Analysis Admin | Job function role | Allows the user to upload and analyze firmware images. The user has no access beyond firmware analysis (can't access other resources in the subscription, create or delete resources, or invite other users). |
Firmware analysis roles, scopes, and capabilities
The following table summarizes what roles you need to perform certain actions. These roles and permissions apply at the Subscription, Resource Group, and Workspace levels, unless otherwise stated.
Action | Role required |
---|---|
Analyze firmware | Owner, Contributor, Security Admin, or Firmware Analysis Admin |
Invite third party users to see firmware analysis results | Owner |
Invite users to the Subscription | Owner at the Subscription level (Owner at the Resource Group level cannot invite users to the Subscription) |
Uploading Firmware images
To upload firmware images:
- Confirm that you have sufficient permission in Firmware analysis Roles, Scopes, and Capabilities.
- Upload a firmware image for analysis.
Invite third parties to interact with your firmware analysis results
You might want to invite someone to interact solely with your firmware analysis results, without allowing access to other parts of your organization (like other resource groups within your subscription). To allow this type of access, invite the user as a Firmware Analysis Admin at the Resource Group or Workspace level.
To invite a third party, you must first invite them to your directory. To do this, follow the Assign Azure roles to external guest users using the Azure portal tutorial.
- In step 3, navigate to your resource group.
- In step 7, select the Firmware Analysis Admin role.
Note
If you received an email to join an organization, be sure to check your Junk folder for the invitation email if you don't see it in your inbox.