# Documentación API NET (Nube Empresarial Telmex)
## Introducción
Éste proyecto brinda la posibilidad de solicitar el aprovisionamiento o contratación de distintos servicios, actualmente se disponen dos tipos  listos para su contratación:
### BDaaS
Bases de datos clusterizadas o "standalone", tales como:
- Redis
- RabbitMQ
- PostgreSQL
- Oracle Database
- MongoDB
- MariaDB
- Apache Kafka
- Apache Hadoop
- CouchDB
- ApacheCassandra

*El listado presentado se encuentra sujeto a cambios y no aplica para todos los casos los tipos de servicios clusterizados o "standalone"*
### SECaaS
Servicios de ciberseguridad, tales como:
- Carbon Black Cloud - NGAV
- Fortanix - KMS/HSM
## Empezando
El uso de la API NET es exclusiva para usuarios registrados en plataforma de administración de nube VCD (VMware Cloud Director) dentro de los ambientes y tenants generados y proporcionados por Telmex/Triara.
## Autenticación
Existen 3 modos de autenticación para el uso de ésta API, algunos de éstos modos deben utilizarse acorde dónde se consuma dicha API y para algunos casos se requiere la generación de API Keys:
### X-DAAS-TOKEN
El método de autenticación por token X-DAAS-TOKEN se puede generar desde una petición sobre un método de la misma API (/session), a continuación se presenta un ejemplo sobre el que se reemplazará la información acorde al ambiente y usuario de los que se generará un token de sesión, éste ejemplo de realiza con una petición http ejecutada con cURL:
```
$ curl -u {usuario}@{tenant}:{contraseña} {api-hostname}/session \
-X POST \
-H 'Content-Type: application/json'
```
Si la petición fue correcta, la petición arrojará una respuesta tipo JSON con un elemento token con el valor del token generado y con una vigencia de 30 minutos por defecto. La implementación para realizar una petición a cualquiera de los métodos API sería añadiendo desde las cabeceras x-daas-token, por ejemplo:
```
$ curl {api-hostname}/category_services \
-X GET \
-H 'x-daas-token: {api-token}' \
-H 'Content-Type: application/json'
```
### TF-DASS-TOKEN
Similar al método de autenticación por token X-DAAS-TOKEN, se requiere la generación de un token, sólo que en éste caso sería la generación desde el portal de administración VCD, con el plugin NET instalado:

*Pendiente desarrollo en frontend para añadir capturas*

### Bearer token