yandex_iam_workload_identity_oidc_federation (Resource)
Written by
Updated at October 30, 2025
A OIDC workload identity federation.
Example Usage
//
// Create a new IAM Workload Identity OIDC Federation.
//
resource "yandex_iam_workload_identity_oidc_federation" "wlif" {
name = "some_wlif_name"
folder_id = "some_folder_id"
description = "some description"
disabled = false
audiences = ["aud1", "aud2"]
issuer = "https://example-issuer.com"
jwks_url = "https://example-issuer.com/jwks"
labels = {
key1 = "value1"
key2 = "value2"
}
}
Schema
Required
issuer(String) URL of the external IdP server to be used for authentication.jwks_url(String) URL reference to trusted keys in format of JSON Web Key Set.name(String) Name of the OIDC workload identity federation
The name is unique within the folder. 3-63 characters long.
Optional
audiences(Set of String) List of trusted values for aud claim.description(String) Description of the service account. 0-256 characters long.disabled(Boolean) True - the OIDC workload identity federation is disabled and cannot be used for authentication.
False - the OIDC workload identity federation is enabled and can be used for authentication.federation_id(String) ID of the OIDC workload identity federation to return.
To get the OIDC workload identity federation ID, make a [FederationService.List] request.folder_id(String) ID of the folder that the OIDC workload identity federation belongs to.id(String) ID of the OIDC workload identity federation to return.
To get the OIDC workload identity federation ID, make a [FederationService.List] request.labels(Map of String) Resource labels askey:valuepairstimeouts(Block, Optional) (see below for nested schema)
Read-Only
created_at(String) Creation timestamp.enabled(Boolean) True - the OIDC workload identity federation is enabled and can be used for authentication.
False - the OIDC workload identity federation is disabled and cannot be used for authentication.
Nested Schema for timeouts
Optional:
create(String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).delete(String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.read(String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.update(String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
Import
The resource can be imported by using their resource ID. For getting the resource ID you can use Yandex Cloud Web Console
# terraform import yandex_iam_workload_identity_oidc_federation.<resource Name> <resource Id>
terraform import yandex_iam_workload_identity_oidc_federation.wlif ...