Skip to content

docs(byob): document Azure workload identity setup - #2967

Merged
mdlinville merged 15 commits into
mainfrom
agent/azure-byob-auth-docs
Sep 11, 2026
Merged

docs(byob): document Azure workload identity setup#2967
mdlinville merged 15 commits into
mainfrom
agent/azure-byob-auth-docs

Conversation

@zacharyblasczyk

@zacharyblasczyk zacharyblasczyk commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Summary

Explain how customers connect an Azure bucket using a storage account key or workload identity. Dedicated Cloud customers coordinate the identity with W&B, configure federation when an identity in their own Azure tenant is needed, grant storage access, and provide their bucket and identity details. Self-Managed administrators get the supported versions, identity and Kubernetes setup requirements, a link to the Helm configuration guide, and the Console steps.

Keep the public guidance focused on customer actions. Remove internal rollout flags, migration and rollback mechanics, spec precedence, and default-storage compatibility details. Preserve the existing Weave reference-storage clarification and the common bucket configuration procedure for other providers.

Verification

  • mint validate: passed.
  • mint broken-links: no broken links.
  • git diff --check: passed.
  • Checked Azure setup requirements against Microsoft documentation and W&B configuration against released Operator Helm 0.44.13 and Console 2.20.0.

Jira: WB-38013.

@mintlify

mintlify Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
wandb 🟢 Ready View Preview Sep 11, 2026, 8:41 PM

@github-actions

github-actions Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

📚 Mintlify Preview Links

🔗 View Full Preview

📝 Changed (3 total)

📄 Pages (3)

File Preview
platform/hosting/data-security/secure-storage-connector.mdx Secure Storage Connector
snippets/_includes/byob-reference-setup.mdx Byob Reference Setup
snippets/_includes/weave-byob.mdx Weave Byob

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: 119a709 at 2026-09-09 22:08:31 UTC

@github-actions

github-actions Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Preview: https://wb-21fd5541-agent-azure-byob-auth-docs.mintlify.site

@mintlify

mintlify Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟡 Building Jul 27, 2026, 7:47 PM

@github-actions

github-actions Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Readability impact

Word-weighted Flesch-Kincaid grade change across 2 changed pages: +0.3 (harder).

Lower Flesch-Kincaid grade and higher reading ease both mean easier to read. This check is informational and never blocks a PR.

Human readability

Page FK grade before FK grade after FK Δ Reading ease Δ Direction
platform/hosting/data-security/secure-storage-connector.mdx 9.3 9.6 +0.3 -2.2 harder
snippets/_includes/byob-reference-setup.mdx 7.5 7.6 +0.1 -0.3 harder
snippets/_includes/weave-byob.mdx 10.1 n/a

AI agent comprehension

Rated 0-3 (higher is easier for an agent to parse and act on).

Page Before After Δ
platform/hosting/data-security/secure-storage-connector.mdx 2 2 +0
snippets/_includes/byob-reference-setup.mdx 3 3 +0
snippets/_includes/weave-byob.mdx 2

Curated-docs baseline median FK grade by type: conceptual 10.5, procedural 8.8, reference 9.4.

From workflow run 34645268927

@mdlinville
mdlinville self-requested a review August 19, 2026 20:53

@mdlinville mdlinville left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WDYT?

Comment thread platform/hosting/data-security/secure-storage-connector.mdx Outdated
zacharyblasczyk and others added 3 commits August 19, 2026 16:20
Co-authored-by: Matt Linville <mlinville@coreweave.com>
Co-authored-by: Matt Linville <mlinville@coreweave.com>
Co-authored-by: Matt Linville <mlinville@coreweave.com>
Updated the prerequisites section to include support for Dedicated Cloud and Self-Managed options.
Comment thread snippets/_includes/byob-reference-setup.mdx Outdated
Comment thread platform/hosting/data-security/secure-storage-connector.mdx Outdated
Comment thread platform/hosting/data-security/secure-storage-connector.mdx Outdated
Co-authored-by: Matt Linville <matt@linville.me>
Comment thread snippets/_includes/byob-reference-setup.mdx Outdated
@zacharyblasczyk zacharyblasczyk changed the title docs(byob): explain Azure authentication options docs(byob): document Azure workload identity setup Sep 9, 2026
@mdlinville
mdlinville marked this pull request as ready for review September 11, 2026 20:39
@mdlinville
mdlinville requested a review from a team as a code owner September 11, 2026 20:39
@mdlinville
mdlinville enabled auto-merge (squash) September 11, 2026 20:41
@mdlinville
mdlinville merged commit f68e4fb into main Sep 11, 2026
12 checks passed
@mdlinville
mdlinville deleted the agent/azure-byob-auth-docs branch September 11, 2026 20:42
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.

3 participants