Manage GCP Secret Manager IAM Access

The gcp:secretmanager/regionalSecretIamMember:RegionalSecretIamMember resource, part of the Pulumi GCP provider, manages IAM access to regional secrets by adding individual members to roles without affecting other permissions. This guide focuses on three capabilities: single-member access grants, time-limited access with IAM Conditions, and role-level and policy-level IAM management.

Regional secret IAM resources reference existing secrets and must be chosen carefully. RegionalSecretIamMember is non-authoritative (adds one member), RegionalSecretIamBinding is authoritative for a role (replaces all members for that role), and RegionalSecretIamPolicy is fully authoritative (replaces the entire policy). The examples are intentionally small. Choose the resource type that matches your access control requirements.

Grant access to a single identity

Most access patterns start by granting a specific user or service account permission to read secret values without affecting other members or roles.

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const member = new gcp.secretmanager.RegionalSecretIamMember("member", {
    project: regional_secret_basic.project,
    location: regional_secret_basic.location,
    secretId: regional_secret_basic.secretId,
    role: "roles/secretmanager.secretAccessor",
    member: "user:jane@example.com",
});

import pulumi
import pulumi_gcp as gcp

member = gcp.secretmanager.RegionalSecretIamMember("member",
    project=regional_secret_basic["project"],
    location=regional_secret_basic["location"],
    secret_id=regional_secret_basic["secretId"],
    role="roles/secretmanager.secretAccessor",
    member="user:jane@example.com")

package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/secretmanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := secretmanager.NewRegionalSecretIamMember(ctx, "member", &secretmanager.RegionalSecretIamMemberArgs{
			Project:  pulumi.Any(regional_secret_basic.Project),
			Location: pulumi.Any(regional_secret_basic.Location),
			SecretId: pulumi.Any(regional_secret_basic.SecretId),
			Role:     pulumi.String("roles/secretmanager.secretAccessor"),
			Member:   pulumi.String("user:jane@example.com"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var member = new Gcp.SecretManager.RegionalSecretIamMember("member", new()
    {
        Project = regional_secret_basic.Project,
        Location = regional_secret_basic.Location,
        SecretId = regional_secret_basic.SecretId,
        Role = "roles/secretmanager.secretAccessor",
        Member = "user:jane@example.com",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.secretmanager.RegionalSecretIamMember;
import com.pulumi.gcp.secretmanager.RegionalSecretIamMemberArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var member = new RegionalSecretIamMember("member", RegionalSecretIamMemberArgs.builder()
            .project(regional_secret_basic.project())
            .location(regional_secret_basic.location())
            .secretId(regional_secret_basic.secretId())
            .role("roles/secretmanager.secretAccessor")
            .member("user:jane@example.com")
            .build());

    }
}

resources:
  member:
    type: gcp:secretmanager:RegionalSecretIamMember
    properties:
      project: ${["regional-secret-basic"].project}
      location: ${["regional-secret-basic"].location}
      secretId: ${["regional-secret-basic"].secretId}
      role: roles/secretmanager.secretAccessor
      member: user:jane@example.com

The member property specifies the identity (user, service account, group, or special identifier). The role property defines the permission level; roles/secretmanager.secretAccessor allows reading secret values. RegionalSecretIamMember is non-authoritative: it adds this one member to this one role, preserving all other IAM bindings on the secret.

Grant time-limited access with IAM Conditions

Temporary access grants expire automatically when conditions evaluate to false, removing the need for manual cleanup.

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const member = new gcp.secretmanager.RegionalSecretIamMember("member", {
    project: regional_secret_basic.project,
    location: regional_secret_basic.location,
    secretId: regional_secret_basic.secretId,
    role: "roles/secretmanager.secretAccessor",
    member: "user:jane@example.com",
    condition: {
        title: "expires_after_2019_12_31",
        description: "Expiring at midnight of 2019-12-31",
        expression: "request.time < timestamp(\"2020-01-01T00:00:00Z\")",
    },
});

import pulumi
import pulumi_gcp as gcp

member = gcp.secretmanager.RegionalSecretIamMember("member",
    project=regional_secret_basic["project"],
    location=regional_secret_basic["location"],
    secret_id=regional_secret_basic["secretId"],
    role="roles/secretmanager.secretAccessor",
    member="user:jane@example.com",
    condition={
        "title": "expires_after_2019_12_31",
        "description": "Expiring at midnight of 2019-12-31",
        "expression": "request.time < timestamp(\"2020-01-01T00:00:00Z\")",
    })

package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/secretmanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := secretmanager.NewRegionalSecretIamMember(ctx, "member", &secretmanager.RegionalSecretIamMemberArgs{
			Project:  pulumi.Any(regional_secret_basic.Project),
			Location: pulumi.Any(regional_secret_basic.Location),
			SecretId: pulumi.Any(regional_secret_basic.SecretId),
			Role:     pulumi.String("roles/secretmanager.secretAccessor"),
			Member:   pulumi.String("user:jane@example.com"),
			Condition: &secretmanager.RegionalSecretIamMemberConditionArgs{
				Title:       pulumi.String("expires_after_2019_12_31"),
				Description: pulumi.String("Expiring at midnight of 2019-12-31"),
				Expression:  pulumi.String("request.time < timestamp(\"2020-01-01T00:00:00Z\")"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var member = new Gcp.SecretManager.RegionalSecretIamMember("member", new()
    {
        Project = regional_secret_basic.Project,
        Location = regional_secret_basic.Location,
        SecretId = regional_secret_basic.SecretId,
        Role = "roles/secretmanager.secretAccessor",
        Member = "user:jane@example.com",
        Condition = new Gcp.SecretManager.Inputs.RegionalSecretIamMemberConditionArgs
        {
            Title = "expires_after_2019_12_31",
            Description = "Expiring at midnight of 2019-12-31",
            Expression = "request.time < timestamp(\"2020-01-01T00:00:00Z\")",
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.secretmanager.RegionalSecretIamMember;
import com.pulumi.gcp.secretmanager.RegionalSecretIamMemberArgs;
import com.pulumi.gcp.secretmanager.inputs.RegionalSecretIamMemberConditionArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var member = new RegionalSecretIamMember("member", RegionalSecretIamMemberArgs.builder()
            .project(regional_secret_basic.project())
            .location(regional_secret_basic.location())
            .secretId(regional_secret_basic.secretId())
            .role("roles/secretmanager.secretAccessor")
            .member("user:jane@example.com")
            .condition(RegionalSecretIamMemberConditionArgs.builder()
                .title("expires_after_2019_12_31")
                .description("Expiring at midnight of 2019-12-31")
                .expression("request.time < timestamp(\"2020-01-01T00:00:00Z\")")
                .build())
            .build());

    }
}

resources:
  member:
    type: gcp:secretmanager:RegionalSecretIamMember
    properties:
      project: ${["regional-secret-basic"].project}
      location: ${["regional-secret-basic"].location}
      secretId: ${["regional-secret-basic"].secretId}
      role: roles/secretmanager.secretAccessor
      member: user:jane@example.com
      condition:
        title: expires_after_2019_12_31
        description: Expiring at midnight of 2019-12-31
        expression: request.time < timestamp("2020-01-01T00:00:00Z")

The condition block adds time-based or attribute-based restrictions. The expression uses Common Expression Language (CEL) to define when access is valid; here, access expires at midnight on 2020-01-01. The title and description document the condition’s purpose. IAM Conditions have known limitations documented in the GCP IAM Conditions overview.

Manage all members for a role with Binding

When you need to control the complete list of identities for a role, RegionalSecretIamBinding replaces all members for that role while preserving other roles.

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const binding = new gcp.secretmanager.RegionalSecretIamBinding("binding", {
    project: regional_secret_basic.project,
    location: regional_secret_basic.location,
    secretId: regional_secret_basic.secretId,
    role: "roles/secretmanager.secretAccessor",
    members: ["user:jane@example.com"],
});

import pulumi
import pulumi_gcp as gcp

binding = gcp.secretmanager.RegionalSecretIamBinding("binding",
    project=regional_secret_basic["project"],
    location=regional_secret_basic["location"],
    secret_id=regional_secret_basic["secretId"],
    role="roles/secretmanager.secretAccessor",
    members=["user:jane@example.com"])

package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/secretmanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := secretmanager.NewRegionalSecretIamBinding(ctx, "binding", &secretmanager.RegionalSecretIamBindingArgs{
			Project:  pulumi.Any(regional_secret_basic.Project),
			Location: pulumi.Any(regional_secret_basic.Location),
			SecretId: pulumi.Any(regional_secret_basic.SecretId),
			Role:     pulumi.String("roles/secretmanager.secretAccessor"),
			Members: pulumi.StringArray{
				pulumi.String("user:jane@example.com"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var binding = new Gcp.SecretManager.RegionalSecretIamBinding("binding", new()
    {
        Project = regional_secret_basic.Project,
        Location = regional_secret_basic.Location,
        SecretId = regional_secret_basic.SecretId,
        Role = "roles/secretmanager.secretAccessor",
        Members = new[]
        {
            "user:jane@example.com",
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.secretmanager.RegionalSecretIamBinding;
import com.pulumi.gcp.secretmanager.RegionalSecretIamBindingArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var binding = new RegionalSecretIamBinding("binding", RegionalSecretIamBindingArgs.builder()
            .project(regional_secret_basic.project())
            .location(regional_secret_basic.location())
            .secretId(regional_secret_basic.secretId())
            .role("roles/secretmanager.secretAccessor")
            .members("user:jane@example.com")
            .build());

    }
}

resources:
  binding:
    type: gcp:secretmanager:RegionalSecretIamBinding
    properties:
      project: ${["regional-secret-basic"].project}
      location: ${["regional-secret-basic"].location}
      secretId: ${["regional-secret-basic"].secretId}
      role: roles/secretmanager.secretAccessor
      members:
        - user:jane@example.com

The members property takes a list of identities. RegionalSecretIamBinding is authoritative for the specified role: it replaces all members for roles/secretmanager.secretAccessor but leaves other roles unchanged. You can combine RegionalSecretIamBinding with RegionalSecretIamMember only if they manage different roles.

Replace the entire IAM policy with Policy

Some workflows require complete control over all roles and members, replacing any existing policy.

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const admin = gcp.organizations.getIAMPolicy({
    bindings: [{
        role: "roles/secretmanager.secretAccessor",
        members: ["user:jane@example.com"],
    }],
});
const policy = new gcp.secretmanager.RegionalSecretIamPolicy("policy", {
    project: regional_secret_basic.project,
    location: regional_secret_basic.location,
    secretId: regional_secret_basic.secretId,
    policyData: admin.then(admin => admin.policyData),
});

import pulumi
import pulumi_gcp as gcp

admin = gcp.organizations.get_iam_policy(bindings=[{
    "role": "roles/secretmanager.secretAccessor",
    "members": ["user:jane@example.com"],
}])
policy = gcp.secretmanager.RegionalSecretIamPolicy("policy",
    project=regional_secret_basic["project"],
    location=regional_secret_basic["location"],
    secret_id=regional_secret_basic["secretId"],
    policy_data=admin.policy_data)

package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/organizations"
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/secretmanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		admin, err := organizations.LookupIAMPolicy(ctx, &organizations.LookupIAMPolicyArgs{
			Bindings: []organizations.GetIAMPolicyBinding{
				{
					Role: "roles/secretmanager.secretAccessor",
					Members: []string{
						"user:jane@example.com",
					},
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		_, err = secretmanager.NewRegionalSecretIamPolicy(ctx, "policy", &secretmanager.RegionalSecretIamPolicyArgs{
			Project:    pulumi.Any(regional_secret_basic.Project),
			Location:   pulumi.Any(regional_secret_basic.Location),
			SecretId:   pulumi.Any(regional_secret_basic.SecretId),
			PolicyData: pulumi.String(admin.PolicyData),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var admin = Gcp.Organizations.GetIAMPolicy.Invoke(new()
    {
        Bindings = new[]
        {
            new Gcp.Organizations.Inputs.GetIAMPolicyBindingInputArgs
            {
                Role = "roles/secretmanager.secretAccessor",
                Members = new[]
                {
                    "user:jane@example.com",
                },
            },
        },
    });

    var policy = new Gcp.SecretManager.RegionalSecretIamPolicy("policy", new()
    {
        Project = regional_secret_basic.Project,
        Location = regional_secret_basic.Location,
        SecretId = regional_secret_basic.SecretId,
        PolicyData = admin.Apply(getIAMPolicyResult => getIAMPolicyResult.PolicyData),
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.organizations.OrganizationsFunctions;
import com.pulumi.gcp.organizations.inputs.GetIAMPolicyArgs;
import com.pulumi.gcp.secretmanager.RegionalSecretIamPolicy;
import com.pulumi.gcp.secretmanager.RegionalSecretIamPolicyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var admin = OrganizationsFunctions.getIAMPolicy(GetIAMPolicyArgs.builder()
            .bindings(GetIAMPolicyBindingArgs.builder()
                .role("roles/secretmanager.secretAccessor")
                .members("user:jane@example.com")
                .build())
            .build());

        var policy = new RegionalSecretIamPolicy("policy", RegionalSecretIamPolicyArgs.builder()
            .project(regional_secret_basic.project())
            .location(regional_secret_basic.location())
            .secretId(regional_secret_basic.secretId())
            .policyData(admin.policyData())
            .build());

    }
}

resources:
  policy:
    type: gcp:secretmanager:RegionalSecretIamPolicy
    properties:
      project: ${["regional-secret-basic"].project}
      location: ${["regional-secret-basic"].location}
      secretId: ${["regional-secret-basic"].secretId}
      policyData: ${admin.policyData}
variables:
  admin:
    fn::invoke:
      function: gcp:organizations:getIAMPolicy
      arguments:
        bindings:
          - role: roles/secretmanager.secretAccessor
            members:
              - user:jane@example.com

RegionalSecretIamPolicy sets the full policy document via policyData, which comes from the getIAMPolicy data source. This resource is fully authoritative: it replaces the entire IAM policy on the secret. It cannot be used with RegionalSecretIamBinding or RegionalSecretIamMember; they will conflict over policy state.

Beyond these examples

These snippets focus on specific IAM management features: single-member grants, role-level member lists, full policy replacement, and time-based access with IAM Conditions. They’re intentionally minimal rather than complete access control configurations.

The examples reference pre-existing infrastructure such as regional secrets and GCP project and location configuration. They focus on IAM binding configuration rather than secret creation or policy design.

To keep things focused, common IAM patterns are omitted, including:

  • Custom role definitions and formatting
  • Federated identity and workload identity pool configuration
  • Policy conflict resolution between resource types
  • IAM Condition limitations and troubleshooting

These omissions are intentional: the goal is to illustrate how each IAM resource type is wired, not provide drop-in access control modules. See the Regional Secret IAM Member resource reference for all available configuration options.

Let's manage GCP Secret Manager IAM Access

Get started with Pulumi Cloud, then follow our quick setup guide to deploy this infrastructure.

Try Pulumi Cloud for FREE

Frequently Asked Questions

Resource Selection & Conflicts
What's the difference between RegionalSecretIamPolicy, RegionalSecretIamBinding, and RegionalSecretIamMember?
RegionalSecretIamPolicy is fully authoritative and replaces the entire IAM policy. RegionalSecretIamBinding is authoritative for a specific role, replacing all members for that role while preserving other roles. RegionalSecretIamMember is non-authoritative, adding a single member to a role without affecting other members.
Which IAM resources can I use together?
You cannot use RegionalSecretIamPolicy with RegionalSecretIamBinding or RegionalSecretIamMember, as they will conflict over policy state. However, you can use RegionalSecretIamBinding and RegionalSecretIamMember together, but only if they don’t grant privileges to the same role.
IAM Configuration
What identity formats are supported for the member parameter?
The member parameter supports multiple formats: allUsers, allAuthenticatedUsers, user:{email}, serviceAccount:{email}, group:{email}, domain:{domain}, projectOwner/Editor/Viewer:{projectid}, and federated identities like principal://iam.googleapis.com/locations/global/workforcePools/....
What format should I use for custom roles?
Custom roles must use the format [projects|organizations]/{parent-name}/roles/{role-name}. For example, projects/my-project/roles/my-custom-role or organizations/my-org/roles/my-custom-role.
Can I use multiple RegionalSecretIamBinding resources for the same role?
No, only one RegionalSecretIamBinding can be used per role, as it’s authoritative for that role and will replace all members.
IAM Conditions
How do I add time-based or conditional access to IAM permissions?
Use the condition property with title, description, and expression fields. For example, to expire access at a specific time: expression: "request.time < timestamp(\"2020-01-01T00:00:00Z\")". Note that IAM Conditions have known limitations documented by GCP.
Import & Operations
What format should I use when importing IAM resources with custom roles?
When importing, use the full custom role name in the format [projects/my-project|organizations/my-org]/roles/my-custom-role. For example: pulumi import gcp:secretmanager/regionalSecretIamMember:RegionalSecretIamMember editor "projects/my-project/locations/us-central1/secrets/my-secret roles/my-custom-role user:jane@example.com".
What properties are immutable after creation?
The location, member, project, role, secretId, and condition properties are all immutable and cannot be changed after resource creation.

Using a different cloud?

Explore security guides for other cloud providers:

AWS Guides Azure Guides