aws_public_ips

Table des matières

• À quoi ça sert
• Démarrage rapide
• Référence CLI
• Configuration
• Permissions IAM
• Journal des modifications
• Contribuer
• Contact

À quoi ça sert

aws_public_ips est un outil pour récupérer toutes les adresses IP publiques (IPv4 et IPv6) associées à un compte AWS.

Il peut être utilisé comme bibliothèque et comme CLI, et prend en charge les services AWS suivants (tous avec les variantes Classic et VPC) :

• APIGateway
• CloudFront
• EC2 (et par conséquent : ECS, EKS, Beanstalk, Fargate, Batch, et instances NAT)
• ElasticSearch
• ELB (Classic ELB)
• ELBv2 (ALB/NLB)
• Lightsail
• RDS
• Redshift

Si un service n'est pas listé (S3, ElastiCache, etc.), c'est probablement parce qu'il n'a rien à prendre en charge (c'est-à-dire qu'il n'est peut-être pas déployable publiquement, que toutes ses adresses IP peuvent résoudre sur l'infrastructure globale AWS, etc.).

Démarrage rapide

Installez le gem et exécutez-le :

$ gem install aws_public_ips

# Uses default ~/.aws/credentials
$ aws_public_ips
52.84.11.13
52.84.11.83
2600:9000:2039:ba00:1a:cd27:1440:93a1
2600:9000:2039:6e00:1a:cd27:1440:93a1

# With a custom profile
$ AWS_PROFILE=production aws_public_ips
52.84.11.159

Le gem peut également être exécuté depuis Docker :

$ docker pull arkadiyt/aws_public_ips

# For credentials, ensure the appropriate environment variables are defined in the host environment:
$ docker run -e AWS_REGION -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN arkadiyt/aws_public_ips

Référence CLI

$ aws_public_ips --help
Usage: aws_public_ips [options]
    -s, --services <s1>,<s2>,<s3>    List of AWS services to check. Available services: apigateway,cloudfront,ec2,elasticsearch,elb,elbv2,lightsail,rds,redshift. Defaults to all.
    -f, --format <format>            Set output format. Available formats: json,prettyjson,text. Defaults to text.
    -v, --[no-]verbose               Enable debug/trace output
        --version                    Print version
    -h, --help                       Show this help message

Configuration

Pour l'authentification, aws_public_ips utilise la configuration par défaut d'aws-sdk-ruby, ce qui signifie que les éléments suivants sont vérifiés dans l'ordre :

1. Variables d'environnement :

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY
• AWS_REGION
• AWS_PROFILE

2. Fichiers d'identifiants partagés :

• ~/.aws/credentials
• ~/.aws/config

3. Profil d'instance via le point de terminaison de métadonnées (si exécuté sur EC2, ECS, EKS ou Fargate)

Pour plus d'informations, consultez la documentation sur la configuration du SDK AWS.

Permissions IAM

Pour trouver les IP publiques de tous les services AWS, la politique minimale requise par votre utilisateur IAM est :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "apigateway:GET",
        "cloudfront:ListDistributions",
        "ec2:DescribeInstances",
        "elasticloadbalancing:DescribeLoadBalancers",
        "lightsail:GetInstances",
        "lightsail:GetLoadBalancers",
        "rds:DescribeDBInstances",
        "redshift:DescribeClusters",
        "es:ListDomainNames"
      ],
      "Resource": "*"
    }
  ]
}

Journal des modifications

Veuillez consulter CHANGELOG.md. Ce projet suit le versionnement sémantique.

Contribuer

Veuillez consulter CONTRIBUTING.md.

Contact

N'hésitez pas à tweeter ou à m'envoyer un message direct : @arkadiyt