Primer commit
This commit is contained in:
Dsupanta
@@ -0,0 +1,62 @@
|
||||
# Environment and secrets
|
||||
.env
|
||||
.env.*
|
||||
credentials
|
||||
aws-credentials
|
||||
aws_session.json
|
||||
|
||||
# AWS keys and certificates
|
||||
*.pem
|
||||
*.key
|
||||
*.crt
|
||||
*.p12
|
||||
|
||||
# Amplify / Cognito / AWS Mobile
|
||||
amplify/
|
||||
# Preserve local Amplify config? ignore current cloud backend
|
||||
amplify/#current-cloud-backend/
|
||||
aws-exports.js
|
||||
aws-exports.ts
|
||||
aws-exports*.js
|
||||
aws-exports*.ts
|
||||
.aws-amplify/
|
||||
.awsmobile
|
||||
|
||||
# Serverless / SAM
|
||||
.serverless/
|
||||
.aws-sam/
|
||||
.aws-sam/build/
|
||||
|
||||
# IoT certificates / keys
|
||||
certs/
|
||||
private/
|
||||
*.jks
|
||||
|
||||
# Build artifacts
|
||||
dist/
|
||||
build/
|
||||
out/
|
||||
|
||||
# Node / Python
|
||||
node_modules/
|
||||
venv/
|
||||
.venv/
|
||||
__pycache__/
|
||||
*.py[cod]
|
||||
|
||||
# Terraform
|
||||
.terraform/
|
||||
*.tfstate
|
||||
*.tfstate.*
|
||||
crash.log
|
||||
|
||||
# Editor/OS
|
||||
.vscode/
|
||||
.idea/
|
||||
.DS_Store
|
||||
|
||||
# Misc
|
||||
coverage/
|
||||
npm-debug.log*
|
||||
yarn-debug.log*
|
||||
yarn-error.log*
|
||||
@@ -0,0 +1,104 @@
|
||||
iot-cognito
|
||||
=============
|
||||
|
||||
Resumen
|
||||
-------
|
||||
Este proyecto crea la infraestructura de identidad y autenticación para un proyecto IoT educativo usando Amazon Cognito.
|
||||
|
||||
El objetivo es proporcionar un User Pool y un App Client que puedan ser consumidos por otros proyectos (por ejemplo, una API y un frontend Vue) sin contener lógica de aplicación, Lambdas, APIs ni almacenamiento de datos.
|
||||
|
||||
Qué problema resuelve
|
||||
----------------------
|
||||
Proporciona una fuente centralizada de usuarios y credenciales (Cognito User Pool) y un App Client para una SPA (Vue) de modo que otras aplicaciones puedan autenticarse y validar JWTs emitidos por Cognito.
|
||||
|
||||
Recursos que crea
|
||||
-----------------
|
||||
- AWS::Cognito::UserPool (iot-dashboard-users)
|
||||
- AWS::Cognito::UserPoolClient (iot-dashboard-vue)
|
||||
|
||||
Ambos recursos incluyen tags para facilitar identificación (Project: iot-project, Component: cognito, Environment: dev).
|
||||
|
||||
Outputs
|
||||
-------
|
||||
El stack exporta los siguientes valores (Outputs + Exports):
|
||||
- UserPoolId
|
||||
- UserPoolClientId
|
||||
- UserPoolArn
|
||||
|
||||
Estos valores serán consumidos por los proyectos:
|
||||
- iot-lambda-dashboardApi
|
||||
- iot-front-dashboard
|
||||
|
||||
Validar el template
|
||||
-------------------
|
||||
Usar el validador de CloudFormation:
|
||||
|
||||
```bash
|
||||
aws cloudformation validate-template \
|
||||
--template-body file://template.yml
|
||||
```
|
||||
|
||||
Desplegar el stack
|
||||
------------------
|
||||
Desplegar con AWS CLI. Este template no crea roles ni recursos IAM nombrados, por lo que no es necesario pasar CAPABILITY_NAMED_IAM.
|
||||
|
||||
```bash
|
||||
aws cloudformation deploy \
|
||||
--template-file template.yml \
|
||||
--stack-name iot-cognito
|
||||
```
|
||||
|
||||
Si el despliegue falla por permisos relacionados con IAM (no esperado para este template), añadir la capability requerida:
|
||||
|
||||
```bash
|
||||
aws cloudformation deploy \
|
||||
--template-file template.yml \
|
||||
--stack-name iot-cognito \
|
||||
--capabilities CAPABILITY_NAMED_IAM
|
||||
```
|
||||
|
||||
Obtener los Outputs
|
||||
-------------------
|
||||
Para ver los Outputs directamente desde el stack:
|
||||
|
||||
```bash
|
||||
aws cloudformation describe-stacks \
|
||||
--stack-name iot-cognito \
|
||||
--query "Stacks[0].Outputs" --output table
|
||||
```
|
||||
|
||||
O listar los Exports (útil si otro stack los importa):
|
||||
|
||||
```bash
|
||||
aws cloudformation list-exports --query "Exports[?starts_with(Name, 'iot-cognito')]==[] || Exports" --output table
|
||||
```
|
||||
|
||||
Eliminar el stack
|
||||
-----------------
|
||||
|
||||
```bash
|
||||
aws cloudformation delete-stack --stack-name iot-cognito
|
||||
```
|
||||
|
||||
Notas de uso
|
||||
------------
|
||||
- El App Client creado es público (GenerateSecret: false) y está pensado para una SPA (Vue). No se incluye client secret.
|
||||
- No se crean Lambdas, API Gateway, S3, DynamoDB ni otros recursos fuera del alcance de identidad/usuario.
|
||||
- Mantener este proyecto simple y didáctico facilita que los alumnos entiendan Cognito: User Pools, App Clients, credenciales y JWTs.
|
||||
|
||||
Cómo consumir los valores desde otros stacks
|
||||
-------------------------------------------
|
||||
En otros templates CloudFormation se puede usar `Fn::ImportValue` con los nombres exportados. Por ejemplo:
|
||||
|
||||
```yaml
|
||||
Parameters:
|
||||
CognitoUserPoolId:
|
||||
Type: String
|
||||
Default: !ImportValue "iot-cognito-UserPoolId"
|
||||
```
|
||||
|
||||
Ajustar el nombre del export si el stack se despliega con otro nombre distinto a `iot-cognito`.
|
||||
|
||||
Contacto
|
||||
--------
|
||||
Proyecto educativo preparado para ser utilizado por los ejercicios de la materia.
|
||||
@@ -0,0 +1,68 @@
|
||||
AWSTemplateFormatVersion: '2010-09-09'
|
||||
Description: >-
|
||||
AWS Cognito infrastructure for the IoT Dashboard project.
|
||||
Creates a Cognito User Pool and a public App Client for a Vue SPA.
|
||||
|
||||
Resources:
|
||||
IotDashboardUserPool:
|
||||
Type: AWS::Cognito::UserPool
|
||||
Properties:
|
||||
UserPoolName: iot-dashboard-users
|
||||
AutoVerifiedAttributes:
|
||||
- email
|
||||
UsernameAttributes:
|
||||
- email
|
||||
MfaConfiguration: OFF
|
||||
Policies:
|
||||
PasswordPolicy:
|
||||
MinimumLength: 8
|
||||
RequireUppercase: false
|
||||
RequireNumbers: false
|
||||
RequireSymbols: false
|
||||
AdminCreateUserConfig:
|
||||
AllowAdminCreateUserOnly: false
|
||||
Tags:
|
||||
- Key: Project
|
||||
Value: iot-project
|
||||
- Key: Component
|
||||
Value: cognito
|
||||
- Key: Environment
|
||||
Value: dev
|
||||
|
||||
IotDashboardUserPoolClient:
|
||||
Type: AWS::Cognito::UserPoolClient
|
||||
Properties:
|
||||
ClientName: iot-dashboard-vue
|
||||
GenerateSecret: false
|
||||
UserPoolId: !Ref IotDashboardUserPool
|
||||
ExplicitAuthFlows:
|
||||
- ALLOW_USER_PASSWORD_AUTH
|
||||
- ALLOW_REFRESH_TOKEN_AUTH
|
||||
- ALLOW_USER_SRP_AUTH
|
||||
PreventUserExistenceErrors: ENABLED
|
||||
Tags:
|
||||
- Key: Project
|
||||
Value: iot-project
|
||||
- Key: Component
|
||||
Value: cognito
|
||||
- Key: Environment
|
||||
Value: dev
|
||||
|
||||
Outputs:
|
||||
UserPoolId:
|
||||
Description: Cognito User Pool ID (iot-dashboard-users)
|
||||
Value: !Ref IotDashboardUserPool
|
||||
Export:
|
||||
Name: !Sub "${AWS::StackName}-UserPoolId"
|
||||
|
||||
UserPoolClientId:
|
||||
Description: Cognito User Pool App Client ID (iot-dashboard-vue)
|
||||
Value: !Ref IotDashboardUserPoolClient
|
||||
Export:
|
||||
Name: !Sub "${AWS::StackName}-UserPoolClientId"
|
||||
|
||||
UserPoolArn:
|
||||
Description: ARN of the Cognito User Pool
|
||||
Value: !GetAtt IotDashboardUserPool.Arn
|
||||
Export:
|
||||
Name: !Sub "${AWS::StackName}-UserPoolArn"
|
||||
Reference in New Issue
Block a user