steampipe plugin install aws

Table: aws_iam_open_id_connect_provider - Query AWS IAM OpenID Connect Providers using SQL

The AWS IAM OpenID Connect Provider is a service that allows you to integrate web identity federation with your mobile app, web app, or other AWS resources. This enables users to sign in using a well-known social identity provider such as Login with Amazon, Facebook, Google, or any OpenID Connect (OIDC)-compatible identity provider. It simplifies the sign-in process for your applications and includes built-in security token service (STS), eliminating the need to write any server-side code.

Table Usage Guide

The aws_iam_open_id_connect_provider table in Steampipe provides you with information about OpenID Connect (OIDC) identity providers within AWS Identity and Access Management (IAM). This table allows you, as a DevOps engineer, to query provider-specific details, including ARNs, URLs, client IDs, thumbprint lists, and creation times. You can utilize this table to gather insights on OIDC identity providers, such as their associated client IDs, verification of thumbprint lists, and more. The schema outlines the various attributes of the OIDC identity provider, including the provider ARN, creation date, client ID list, thumbprint list, and URL for you.

Examples

Basic info

Explore which AWS IAM OpenID Connect providers are active, when they were created, and their associated client IDs and URLs. This information can help improve security by identifying potentially unauthorized or outdated connections.

select
arn,
create_date,
client_id_list,
thumbprint_list,
url,
account_id
from
aws_iam_open_id_connect_provider;
select
arn,
create_date,
client_id_list,
thumbprint_list,
url,
account_id
from
aws_iam_open_id_connect_provider;

List providers older than 90 days

Identify instances where the providers have been created more than 90 days ago. This can be useful for auditing purposes, allowing you to track and manage older providers within your AWS IAM Open ID Connect.

select
arn,
create_date,
client_id_list,
thumbprint_list,
url,
account_id
from
aws_iam_open_id_connect_provider
where
create_date <= (current_date - interval '90' day)
order by
create_date;
select
arn,
create_date,
client_id_list,
thumbprint_list,
url,
account_id
from
aws_iam_open_id_connect_provider
where
create_date <= date('now', '-90 day')
order by
create_date;

List providers with specific tags

Determine the areas in which specific tags are associated with providers, particularly in a production environment. This can be useful for managing and categorizing resources within your AWS IAM OpenID Connect providers.

select
arn,
create_date,
client_id_list,
thumbprint_list,
tags,
url,
account_id
from
aws_iam_open_id_connect_provider
where
tags ->> 'Environment' = 'Production';
select
arn,
create_date,
client_id_list,
thumbprint_list,
tags,
url,
account_id
from
aws_iam_open_id_connect_provider
where
json_extract(tags, '$.Environment') = 'Production';

List AWS OpenID Providers without the required thumbprint for audience 'sts.amazonaws.com'

Determine the areas in which AWS OpenID Providers lack the necessary thumbprint for the audience 'sts.amazonaws.com'. This query is useful for identifying potential security gaps in your AWS OpenID configuration.

select
arn,
create_date,
client_id_list,
thumbprint_list,
tags,
url,
account_id
from
aws_iam_open_id_connect_provider
where
client_id_list @> '["sts.amazonaws.com"]' :: jsonb
and not thumbprint_list @> '["1c58a3a8518e8759bf075b76b750d4f2df264fcd", "6938fd4d98bab03faadb97b34396831e3780aea1"]' :: jsonb ` ` ` sql + sqlite Error: The corresponding SQLite query is unavailable.

Schema for aws_iam_open_id_connect_provider

NameTypeOperatorsDescription
_ctxjsonbSteampipe context in JSON form.
account_idtext=, !=, ~~, ~~*, !~~, !~~*The AWS Account ID in which the resource is located.
akasjsonbArray of globally unique identifier strings (also known as) for the resource.
arntext=The Amazon Resource Name (ARN) specifying the OIDC provider resource.
client_id_listjsonbA list of client IDs (also known as audiences) that are associated with the specified IAM OIDC provider resource object.
create_datetimestamp with time zoneThe date and time when the IAM OIDC provider resource object was created in the Amazon Web Services account.
partitiontextThe AWS partition in which the resource is located (aws, aws-cn, or aws-us-gov).
regiontextThe AWS Region in which the resource is located.
sp_connection_nametext=, !=, ~~, ~~*, !~~, !~~*Steampipe connection name.
sp_ctxjsonbSteampipe context in JSON form.
tagsjsonbA map of tags for the resource.
tags_srcjsonbA list of tags that are attached to the specified IAM OIDC provider.
thumbprint_listjsonbA list of certificate thumbprints that are associated with the specified IAM OIDC provider resource object.
urltextThe URL that the IAM OIDC provider resource object is associated with.

Export

This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.

You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh script:

/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- aws

You can pass the configuration to the command with the --config argument:

steampipe_export_aws --config '<your_config>' aws_iam_open_id_connect_provider