Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Feedback: Cloud Storage Authentication

Open
#21,111 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
48/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
azure

Research direction

Start with the cloud-storage-authentication.html page and review its Azure authentication options, especially the managed identity and workload identity sections. Update the guidance to reflect Azure best practices by deprecating managed identity support and recommending Workload Identity first, with simpler choices for new users.

Written by the indexing model from the issue text.

Description

Page: https://cockroachlabs.com/docs/v25.3/cloud-storage-authentication.html

What is the reason for your feedback?

[ ] Missing the information I need

[ ] Too complicated

[x] Out of date

[ ] Something is broken

[ ] Other

Additional details

Simplify and follow best practices on Azure by recommending Workload Identity

  • The current Azure related documents have 4 options - credential file, env variable, managed identity and workload identity. To new azure users it can be overwhelming.
  • Deprecate support for Managed Identity as Azure Managed Identity uses pod identity add on https://github.com/Azure/aad-pod-identity which is now deprecated by Microsoft on 10/24/2022, and the project archived in Sept. 2023. Specifically "Pod identity is EoL and does not get security updates anymore."
  • Recommend Workload Identity. CockroachDB 25.2+ supports Workload Identity and Workload Identity + Federated IAM is viewed as best practice on azure. Could we recommend Workload Identity or list it as the first option?

Jira issue: DOC-15400

Dominant language
HTML
Stars
212
Forks
479
PR merge metrics
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Similar issues

More Security issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.