Identity-based policy examples IAM policies with tags IAM Policies that Control Settings Using Condition Keys Resource-level authorization limitations Console Permissions AWS Managed (Predefined) Policies for AWS Glue Policy updates

Identity-based policies (IAM policies) for access control

Identity-based policies are attached to an IAM identity (user, group, role, or service). This type of policy grants permissions for that IAM identity to access specified resources.

AWS Glue supports identity-based policies (IAM policies) for all AWS Glue operations. By attaching a policy to a user or a group in your account, you can grant them permissions to create, access, or modify an AWS Glue resource, such as a table in the AWS Glue Data Catalog.

By attaching a policy to an IAM role, you can grant cross-account access permissions to IAM identities in other AWS accounts. For more information, see Granting cross-account access.

Topics

Identity-based policy examples
Identity-based policies (IAM policies) with tags
Identity-Based Policies (IAM Policies) that Control Settings Using Condition Keys or Context Keys
Resource-level permissions only apply to specific AWS Glue objects
Permissions Required to Use the AWS Glue Console
AWS Managed (Predefined) Policies for AWS Glue
AWS Glue updates to AWS managed policies

Identity-based policy examples

The following is an example identity-based policy that grants permissions for AWS Glue actions (glue:GetTable, GetTables, GetDatabase, and GetDatabases). The wildcard character (*) in the Resource value means that you are granting permission to these actions to obtain names and details of all the tables and databases in the Data Catalog. If the user also has access to other catalogs through a resource policy, then it is given access to these resources too.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "GetTables",
      "Effect": "Allow",
      "Action": [
        "glue:GetTable",
        "glue:GetTables",
        "glue:GetDatabase",
        "glue:GetDataBases"          
      ],
      "Resource": "*"
    }
  ]
}

Here is another example, targeting the us-west-2 Region and using a placeholder for the specific AWS account number.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "GetTablesActionOnBooks",
      "Effect": "Allow",
      "Action": [
        "glue:GetTable",
        "glue:GetTables"     
      ],
      "Resource": [
        "arn:aws:glue:us-west-2:123456789012:catalog",      
        "arn:aws:glue:us-west-2:123456789012:database/db1",
        "arn:aws:glue:us-west-2:123456789012:table/db1/books"
      ]
    }
  ]
}

This policy grants read-only permission to a table named books in the database named db1. Notice that to grant Get permission to a table that permission to the catalog and database resources is also required.

To deny access to a table, requires that you create a policy to deny a user access to the table, or its parent database or catalog. This allows you to easily deny access to a specific resource that cannot be circumvented with a subsequent allow permission. For example, if you deny access to table books in database db1, then if you grant access to database db1, access to table books is still denied. The following is an example identity-based policy that denies permissions for AWS Glue actions (glue:GetTables and GetTable) to database db1 and all of the tables within it.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DenyGetTablesToDb1",
      "Effect": "Deny",
      "Action": [
        "glue:GetTables",
        "glue:GetTable"        
      ],
      "Resource": [      
        "arn:aws:glue:us-west-2:123456789012:database/db1"
      ]
    }
  ]
}

For more policy examples, see Identity-based policy examples.

Identity-based policies (IAM policies) with tags

You can also control access to certain types of AWS Glue resources using AWS tags. For more information about tags in AWS Glue, see AWS Tags.

You can use the Condition element along with the glue:resourceTag context key in an IAM user policy to allow or deny access based on keys associated with crawlers, jobs, triggers, and development endpoints. For example:


{
    "Version": "2012-10-17",
    "Statement": [
        {
         "Effect": "Allow",
         "Action": "glue:*",
         "Resource": "*",
         "Condition": {
             "StringEquals": {
                "glue:resourceTag/Name": "Tom"
              }
          }
         }
    ]
}

Important

The condition context keys apply only to those AWS Glue API actions on crawlers, jobs, triggers, and development endpoints. For more information about which APIs are affected, see AWS Glue API permissions: actions and resources reference.

For information about how to control access using tags, see Examples of AWS Glue identity-based (IAM) access control policies with tags.

Identity-Based Policies (IAM Policies) that Control Settings Using Condition Keys or Context Keys

You can use condition keys or context keys when granting permissions to create and update jobs. These sections discuss the keys:

IAM Policies that Control Settings Using Condition Keys
IAM Policies that Control Settings Using Context Keys

IAM Policies that Control Settings Using Condition Keys

AWS Glue provides three IAM condition keys glue:VpcIds, glue:SubnetIds and, glue:SecurityGroupIds. You can use the condition keys in IAM policies when granting permissions to create and update jobs. You can use this setting to ensure that jobs are not created (or updated to) to run outside of a desired VPC environment. The VPC setting information is not a direct input from the CreateJob request, but inferred from the Job "connections" field which points to an AWS Glue connection.

Example usage

Create an AWS Glue Network type connection named "traffic-monitored-connection" with the desired VpcId "vpc-id1234", SubnetIds, and SecurityGroupIds.

Specify the condition keys condition for the CreateJob and UpdateJob action in the IAM policy.


{
  "Effect": "Allow",
  "Action": [
    "glue:CreateJob",
    "glue:UpdateJob"
  ],
  "Resource": [
    "*"
  ],
  "Condition": {
    "ForAnyValue:StringLike": {
      "glue:VpcIds": [
        "vpc-id1234"
      ]
    }
  }
}

You can create a similar IAM policy to prohibit creating an AWS Glue job without specifying connection information.

IAM Policies that Control Settings Using Context Keys

AWS Glue provides a context key (glue:CredentialIssuingService= glue.amazonaws.com) to each role session that AWS Glue makes available to the job and developer endpoint. This allows you to implement security controls for the actions taken by AWS Glue scripts. AWS Glue provides another context key (glue:RoleAssumedBy=glue.amazonaws.com) to each role session where AWS Glue makes a call to another AWS service on the customer's behalf (not by a job/dev endpoint but directly by the AWS Glue service).

Example usage

Specify the conditional permission in IAM policy and attach it to the role to be used by an AWS Glue job. This ensures certain actions are allowed/denied based on whether the role session is used for an AWS Glue job execution environment.


{
    "Effect": "Allow",
    "Action": "s3:GetObject",
    "Resource": "arn:aws:s3:::confidential-bucket/*",
    "Condition": {
        "StringEquals": {
            "glue:CredentialIssuingService": "glue.amazonaws.com"
        }
    }
}

Resource-level permissions only apply to specific AWS Glue objects

You can only define fine-grained control for specific objects in AWS Glue. Therefore you must write your client's IAM policy so that API operations that allow Amazon Resource Names (ARNs) for the Resource statement are not mixed with API operations that don't allow ARNs. For example, the following IAM policy allows API operations for GetClassifier and GetJobRun. It defines the Resource as * because AWS Glue doesn't allow ARNs for classifiers and job runs. Because ARNs are allowed for specific API operations such as GetDatabase and GetTable, ARNs can be specified in the second half of the policy.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "glue:GetClassifier*",
                "glue:GetJobRun*"
            ],
            "Resource": "*"   
        },
        {
            "Effect": "Allow",
            "Action": [
                "glue:Get*"
            ],
            "Resource": [
                "arn:aws:glue:us-east-1:123456789012:catalog",
                "arn:aws:glue:us-east-1:123456789012:database/default",
                "arn:aws:glue:us-east-1:123456789012:table/default/e*1*",
                "arn:aws:glue:us-east-1:123456789012:connection/connection2"
            ]
        }
    ]
}

For a list of AWS Glue objects that allow ARNs, see Resource ARNs.

Permissions Required to Use the AWS Glue Console

For a user to work with the AWS Glue console, that user must have a minimum set of permissions that allows them to work with the AWS Glue resources for their AWS account. In addition to these AWS Glue permissions, the console requires permissions from the following services:

Amazon CloudWatch Logs permissions to display logs.
AWS Identity and Access Management (IAM) permissions to list and pass roles.
AWS CloudFormation permissions to work with stacks.
Amazon Elastic Compute Cloud (Amazon EC2) permissions to list VPCs, subnets, security groups, instances, and other objects.
Amazon Simple Storage Service (Amazon S3) permissions to list buckets and objects, and to retrieve and save scripts.
Amazon Redshift permissions to work with clusters.
Amazon Relational Database Service (Amazon RDS) permissions to list instances.

For more information about the permissions that users require to view and work with the AWS Glue console, see Step 3: Attach a Policy to IAM Users That Access AWS Glue.

If you create an IAM policy that is more restrictive than the minimum required permissions, the console won't function as intended for users with that IAM policy. To ensure that those users can still use the AWS Glue console, also attach the AWSGlueConsoleFullAccess managed policy to the user, as described in AWS Managed (Predefined) Policies for AWS Glue.

You don't need to allow minimum console permissions for users that are making calls only to the AWS CLI or the AWS Glue API.

AWS Managed (Predefined) Policies for AWS Glue

AWS addresses many common use cases by providing standalone IAM policies that are created and administered by AWS. These AWS managed policies grant necessary permissions for common use cases so that you can avoid having to investigate what permissions are needed. For more information, see AWS Managed Policies in the IAM User Guide.

The following AWS managed policies, which you can attach to users in your account, are specific to AWS Glue and are grouped by use case scenario:

AWSGlueConsoleFullAccess – Grants full access to AWS Glue resources when using the AWS Management Console. If you follow the naming convention for resources specified in this policy, users have full console capabilities. This policy is typically attached to users of the AWS Glue console.
AWSGlueServiceRole – Grants access to resources that various AWS Glue processes require to run on your behalf. These resources include AWS Glue, Amazon S3, IAM, CloudWatch Logs, and Amazon EC2. If you follow the naming convention for resources specified in this policy, AWS Glue processes have the required permissions. This policy is typically attached to roles specified when defining crawlers, jobs, and development endpoints.
AwsGlueSessionUserRestrictedServiceRole – Provides full access to all AWS Glue resources except for sessions. Allows users to create and use only the interactive sessions that are associated with the user. This policy also includes other permissions needed by AWS Glue to manage Glue resources in other AWS services. The policy also allows adding tags to AWS Glue resources in other AWS services.

Note
To achieve the full security benefits, do not grant this policy to a user that was assigned the AWSGlueServiceRole, AWSGlueConsoleFullAccess, or AWSGlueConsoleSageMakerNotebookFullAccess policy.
AwsGlueSessionUserRestrictedPolicy – Provides access to create AWS Glue interactive sessions using the CreateSession API only if a tag key “owner” and value matching the assignee's AWS user ID is provided. This identity policy is attached to the IAM user that invokes the CreateSession API. This policy also permits the assignee to interact with the AWS Glue interactive session resources that were created with a “owner” tag and value matching their AWS user id. This policy denies permission to change or remove "owner" tags from an AWS Glue session resource after the session is created.

Note
To achieve the full security benefits, do not grant this policy to a user that was assigned the AWSGlueServiceRole, AWSGlueConsoleFullAccess, or AWSGlueConsoleSageMakerNotebookFullAccess policy.
AwsGlueSessionUserRestrictedNotebookServiceRole – Provides sufficient access to the AWS Glue Studio Notebook session to interact with the AWS Glue interactive session resources that are created with the “owner” tag value matching the AWS user id of the principal (IAM user or Role) that creates the Notebook. For more information about these tags, see the Principal key values chart in the IAM User Guide).

This service-role policy is attached to the role that is specified with a magic statement within the notebook or passed as a role to the CreateSession API. This policy also permits the principal to create an AWS Glue interactive session from the AWS Glue Studio Notebook interface only if a tag key “owner” and value matching the AWS user id of the principal. This policy denies permission to change or remove "owner" tags from a AWS Glue session resource after the session is created. This policy also includes permissions for writing and reading from Amazon S3 buckets, writing CloudWatch logs, creating and deleting tags for Amazon EC2 resources used by AWS Glue.

Note
To achieve the full security benefits, do not grant this policy to a role that was assigned the AWSGlueServiceRole, AWSGlueConsoleFullAccess, or AWSGlueConsoleSageMakerNotebookFullAccess policy.
AwsGlueSessionUserRestrictedNotebookPolicy – Provides access to create an AWS Glue interactive session from the AWS Glue Studio Notebook interface only if there is a tag key “owner” and value matching the AWS user id of the principal (IAM user or Role) that creates the Notebook. For more information about these tags, see the Principal key values chart in the IAM User Guide).

This policy is attached to the principal (IAM user or role) that creates sessions from the AWS Glue Studio Notebook interface. This policy also permits sufficient access to the AWS Glue Studio Notebook to interact with the AWS Glue interactive session resources that are created with the “owner” tag value matching the AWS user id of the principal. This policy denies permission to change or remove "owner" tags from an AWS Glue session resource after the session is created.
AWSGlueServiceNotebookRole – Grants access to AWS Glue sessions started in a notebook created in AWS Glue Studio. This policy allows listing and getting session information for all sessions, but only permits users to create and use the sessions tagged with their AWS user id. This policy denies permission to change or remove “owner” tags from AWS Glue session resources tagged with their AWS id.

Assign this policy to the AWS user who creates jobs using the notebook interface in AWS Glue Studio.
AWSGlueConsoleSageMakerNotebookFullAccess – Grants full access to AWS Glue and SageMaker resources when using the AWS Management Console. If you follow the naming convention for resources specified in this policy, users have full console capabilities. This policy is typically attached to users of the AWS Glue console who manage SageMaker notebooks.
AWSGlueSchemaRegistryFullAccess – Grants full access to AWS Glue Schema Registry resources when using the AWS Management Console or AWS CLI. If you follow the naming convention for resources specified in this policy, users have full console capabilities. This policy is typically attached to users of the AWS Glue console or AWS CLI who manage Schema Registry.
AWSGlueSchemaRegistryReadonlyAccess – Grants read-only access to AWS Glue Schema Registry resources when using the AWS Management Console or AWS CLI. If you follow the naming convention for resources specified in this policy, users have full console capabilities. This policy is typically attached to users of the AWS Glue console or AWS CLI who use Schema Registry.

Note

You can review these permissions policies by signing in to the IAM console and searching for specific policies there.

You can also create your own custom IAM policies to allow permissions for AWS Glue actions and resources. You can attach these custom policies to the IAM users or groups that require those permissions.

AWS Glue updates to AWS managed policies

View details about updates to AWS managed policies for AWS Glue since this service began tracking these changes. For automatic alerts about these updates, subscribe to the RSS feed on the AWS Glue Document history page.

Change	Description	Date
New managed policies added for the Interactive Sessions feature AwsGlueSessionUserRestrictedServiceRole AwsGlueSessionUserRestrictedPolicy AwsGlueSessionUserRestrictedNotebookServiceRole AwsGlueSessionUserRestrictedNotebookPolicy	These policies were designed to provide additional security for interactive sesssions and notebooks in AWS Glue Studio. The policies restrict access to the `CreateSession` API so that only the owner has access.	November 30, 2021
AWSGlueConsoleSageMakerNotebookFullAccess – Update to an existing policy	Removed a redundant resource ARN (`arn:aws:s3:::aws-glue-/`) for the action that grants read/write permissions on Amazon S3 buckets that AWS Glue uses to store scripts and temporary files. Fixed a syntax issue by changing `"StringEquals"` to `"ForAnyValue:StringLike"`, and moved the`"Effect": "Allow"` lines to precede the `"Action":` line in each place where they were out of order.	July 15, 2021
AWSGlueConsoleFullAccess – Update to an existing policy	Removed a redundant resource ARN (`arn:aws:s3:::aws-glue-/`) for the action that grants read/write permissions on Amazon S3 buckets that AWS Glue uses to store scripts and temporary files.	July 15, 2021
AWS Glue started tracking changes	AWS Glue started tracking changes for its AWS managed policies.	June 10, 2021

Warning Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

Console permissions

Resource policies