aws_public_ips

Indice

• A cosa serve
• Avvio rapido
• Riferimento CLI
• Configurazione
• Permessi IAM
• Changelog
• Contribuire
• Contatti

A cosa serve

aws_public_ips è uno strumento per recuperare tutti gli indirizzi IP pubblici (sia IPv4 che IPv6) associati a un account AWS.

Può essere utilizzato come libreria e come CLI, e supporta i seguenti servizi AWS (tutti con varianti Classic e VPC):

• APIGateway
• CloudFront
• EC2 (e di conseguenza: ECS, EKS, Beanstalk, Fargate, Batch e istanze NAT)
• ElasticSearch
• ELB (Classic ELB)
• ELBv2 (ALB/NLB)
• Lightsail
• RDS
• Redshift

Se un servizio non è elencato (S3, ElastiCache, ecc.), molto probabilmente è perché non ha nulla da supportare (cioè potrebbe non essere distribuibile pubblicamente, potrebbe avere tutti gli indirizzi IP che risolvono verso l'infrastruttura globale AWS, ecc.).

Avvio rapido

Installa la gemma ed eseguila:

$ 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

La gemma può anche essere eseguita da 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

Riferimento 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

Configurazione

Per l'autenticazione, aws_public_ips utilizza la configurazione predefinita di aws-sdk-ruby, il che significa che vengono controllati nell'ordine:

1. Variabili d'ambiente:

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY
• AWS_REGION
• AWS_PROFILE

2. File di credenziali condivisi:

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

3. Profilo dell'istanza tramite l'endpoint dei metadati (se in esecuzione su EC2, ECS, EKS o Fargate)

Per maggiori informazioni, consulta la documentazione sulla configurazione di AWS SDK.

Permessi IAM

Per trovare gli IP pubblici da tutti i servizi AWS, la policy minima necessaria per il tuo utente IAM è:

{
  "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": "*"
    }
  ]
}

Changelog

Consulta CHANGELOG.md. Questo progetto segue il versionamento semantico.

Contribuire

Consulta CONTRIBUTING.md.

Contatti

Sentiti libero di twittarmi o mandarmi un messaggio diretto: @arkadiyt