CodeForPhilly / CodeForPhilly/codeforphilly-ng

ops: write docs/operations/update-saml2-certificate.md

Abierto Apto para principiantes
#50 0 comentarios 0 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
TypeScript
Estrellas
1
Forks
1
Merge medio
5 d 3 h
PR fusionados (30 d)
9

Descripción

SAML IdP cert rotation procedure to parallel laddr's legacy doc.

Per [specs/api/saml.md](specs/api/saml.md#cert--key-rotation), the rotation steps are:

1. Generate new key + cert
2. Update Slack's admin UI with the new public cert
3. Update the API's SAML_PRIVATE_KEY / SAML_CERTIFICATE secrets
4. Restart the API

The doc should expand these into runnable commands (openssl invocation, Slack admin UI link, our secrets backend), and include the cadence (3 years). Surfaced by the saml-idp plan's closeout (PR #49) — the runbook step isn't owned by any other planned work.

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Línea de trabajo

Crea docs/operations/update-saml2-certificate.md. Comienza con specs/api/saml.md#cert--key-rotation e inspecciona el repositorio en busca del API secrets backend y la configuración de SAML; usa PR #49 como contexto. Se considera terminado cuando el runbook incluya comandos openssl ejecutables, el enlace a la interfaz de administración de Slack, los pasos para actualizar el secret, un paso para reiniciar la API y la cadencia de rotación de tres años.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
typescript
Área
api, documentation, security
Tipo de issue
Documentación
Dificultad
2/5
Tiempo estimado
1-3 horas
Estado de actividad
Tranquilo
Claridad
Bastante claro
Aptitud para principiantes
74/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.