Skip to content

[DCV-4184] [6.2] Document credentials and git keys from your secrets backend, and Datacoves API keys for Airflow - #82

Open
gams87 wants to merge 10 commits into
mainfrom
DCV-4184-security-docs-6.2
Open

gams87 wants to merge 10 commits into
mainfrom
DCV-4184-security-docs-6.2

Conversation

@gams87

@gams87 gams87 commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

One PR for the 6.2 security and Airflow API documentation, replacing #77 and #80 so it can be reviewed and merged together (DCV-4184 is the end-to-end check of these changes).

From #77 (DCV-4077): new how-to page for credentials whose value lives in the customer's own secrets backend (AWS Secrets Manager, Azure Key Vault, GCP Secret Manager, HashiCorp Vault) and is rotated there without touching Datacoves:

  • Snowflake key-pair private keys (DCV-3741, release 6.1).
  • Redshift passwords, Databricks tokens and BigQuery keyfiles (DCV-4075).
  • Key fingerprint and the rotation, failure and recovery notifications (DCV-4100).

It covers requirements, supported backends, storing and referencing the secret, rotation (with the RSA_PUBLIC_KEY_2 overlap for Snowflake), status badges, notifications and troubleshooting. The Snowflake key-pair, service connections and projects pages link to it.

From #80 (DCV-4143): Datacoves API keys for the Airflow API (Airflow 2 and 3, sent as a Bearer token) and the trigger-asset endpoint, with curl and Python examples, the Environment Keys screenshot, and the dag-parse-times page adjusted to the new keys.

New here:

  • Git SSH keys from the secrets backend (DCV-4076): a "Git SSH keys" section on the same page (project deploy key and users' own SSH keys, per-environment backend, testing, rotation, switching back), with links from the projects page (SSH clone strategy) and the SSH keys page. The page title now says "Credentials and Git Keys".
  • Airflow API token scope (DCV-4176): the Airflow variables reference documents DATACOVES__API_TOKEN as a low-privilege per-environment token and says the tasks no longer get the admin service account's credentials, pointing to API keys for calling the Airflow API.

Not included: the Airflow 3 Azure Data Factory page, which applies to every release and went out on its own in #84; the 6.1 pages for the secrets backend selection (#61) and Snowflake authentication (#79), which ship with 6.1. A link from the Snowflake section here to the Snowflake sign-in page of #79 can be added once it merges.

npm run build passes; its only broken-anchor warning (dag-parse-times -> datacoves-my-parse-logs) is also on main.

Merge once 6.2 is released.

Checklist

  • [Mandatory] My pull request represents one logical piece of work and my commits are related and look clean.

🤖 Generated with Claude Code

gams87 and others added 7 commits November 13, 2026 15:51
…s backend

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015pcV34KcZ9UzUQGmj35oJJ
…igger-asset endpoint

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rigger-asset

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…flow API token scope

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
gams87 and others added 3 commits November 18, 2026 14:44
…o status, and when the fingerprint appears

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s under Extra Fields

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This reverts commit 52299de.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant