Skip to content

docs: add OAuth M2M authentication as recommended option for Databricks#2169

Merged
haritamar merged 2 commits intodocsfrom
devin/1774306720-databricks-oauth-docs
Mar 23, 2026
Merged

docs: add OAuth M2M authentication as recommended option for Databricks#2169
haritamar merged 2 commits intodocsfrom
devin/1774306720-databricks-oauth-docs

Conversation

@devin-ai-integration
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot commented Mar 23, 2026

docs: add OAuth M2M auth as recommended option for Databricks

Summary

Updates the Databricks integration docs to document the new OAuth machine-to-machine (M2M) authentication method, positioning it as the recommended option. Personal access tokens are preserved but marked as legacy.

Two files changed:

  • create_service_principal.mdx — Restructured step 6 into two credential options: OAuth secret generation (recommended) and PAT creation (legacy). Old steps 6+7 merged; step 8 renumbered to 7.
  • databricks.mdx (integration snippet) — Split form fields into common fields and auth-method-specific sections. OAuth (M2M) listed first with <Info> callout; Access token listed second with <Warning> callout advising migration.

Three {/* TODO */} screenshot placeholders are included where new screenshots are needed.

Review & Testing Checklist for Human

  • Add screenshots before merging — Three TODO placeholders need real screenshots: (1) Elementary form with OAuth selected, (2) Elementary form with Access token selected, (3) Databricks service principal Secrets tab with "Generate secret" button
  • Verify Mintlify rendering — Check that the nested Option A / Option B content under step 6 in create_service_principal.mdx renders correctly inside the numbered list (indented markdown under list items can be fragile)
  • Test cross-reference links — The [step 5](#create-service-principal) and [step 7](#create-service-principal) anchor links in databricks.mdx reference the imported snippet; verify these resolve correctly in the rendered page
  • Review copy/tone — Confirm the Info and Warning callout text accurately represents the product positioning for OAuth vs legacy tokens

Notes

Co-Authored-By: Itamar Hartstein <haritamar@gmail.com>
@devin-ai-integration
Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@mintlify
Copy link
Copy Markdown

mintlify bot commented Mar 23, 2026

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

Project Status Preview Updated (UTC)
elementary 🟢 Ready View Preview Mar 23, 2026, 11:02 PM

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 23, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5300abb0-959c-40de-aa47-5511a79a0254

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch devin/1774306720-databricks-oauth-docs

Comment @coderabbitai help to get the list of available commands and usage tips.

@haritamar haritamar merged commit 9135dc7 into docs Mar 23, 2026
4 of 5 checks passed
@haritamar haritamar deleted the devin/1774306720-databricks-oauth-docs branch March 23, 2026 23:38
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