Saltar a contenido

Autenticación

Versión del paquete: 0.2.1

Esta guía corresponde a tecsci-cloud-api 0.2.1.

La clave se obtiene exclusivamente de TECSCI_CLOUD_API_KEY. El programa Python debe leer esa variable y entregar su valor al constructor; el constructor no lee el entorno automáticamente. Los comandos de exportación sí lo hacen.

Configurar la sesión

Estos ejemplos solicitan la clave sin escribirla en el comando ni guardarla en el historial.

read -r -s -p "API key de Tecsci Cloud: " TECSCI_CLOUD_API_KEY
printf '\n'
export TECSCI_CLOUD_API_KEY

$clave = Read-Host "API key de Tecsci Cloud" -AsSecureString
$env:TECSCI_CLOUD_API_KEY = [System.Net.NetworkCredential]::new("", $clave).Password
Remove-Variable clave

La variable se hereda por los programas iniciados desde esa terminal. Un editor o notebook ya abierto puede necesitar reiniciarse desde la sesión configurada.

import os
from tecsci_cloud_python_api import TecsciCloudClient

api_key = os.environ.get("TECSCI_CLOUD_API_KEY")
if not api_key or not api_key.strip():
    raise SystemExit("Configurá TECSCI_CLOUD_API_KEY antes de continuar.")

with TecsciCloudClient(api_key=api_key) as client:
    print("Sesión iniciada")

No guardes la clave en código, archivos versionados, notebooks compartidos ni argumentos de terminal. No imprimas su valor ni publiques registros de errores sin revisarlos.

Permisos y errores

  • 401: revisá si la clave es válida, está vigente o fue revocada. Volvé a cargar la clave autorizada.
  • 403: verificá los permisos asociados a la clave para esa entidad y operación. Solicitá únicamente el acceso necesario.

Rotación y revocación

Coordiná la emisión de una nueva clave con quien administra el acceso a Tecsci Cloud, actualizá el entorno de cada proceso, verificá una lectura autorizada y revocá la anterior. Ante una exposición, solicitá su revocación inmediata. Esta interfaz no ofrece métodos públicos para emitir, rotar o revocar API keys.

Al terminar, retirala de la terminal:

unset TECSCI_CLOUD_API_KEY

Remove-Item Env:TECSCI_CLOUD_API_KEY

Eliminar una variable local no revoca la clave ni la elimina de otros procesos. Consultá Seguridad.