Skip to content

docs(motlp): add Authentication section with ingest API key examples#571

Open
alexandra5000 wants to merge 3 commits intoelastic:mainfrom
alexandra5000:motlp-ingest-api-key-auth
Open

docs(motlp): add Authentication section with ingest API key examples#571
alexandra5000 wants to merge 3 commits intoelastic:mainfrom
alexandra5000:motlp-ingest-api-key-auth

Conversation

@alexandra5000
Copy link
Copy Markdown
Collaborator

@alexandra5000 alexandra5000 commented Mar 26, 2026

Summary

  • Adds a new Authentication section to the mOTLP reference doc, positioned between Prerequisites and Send data
  • Documents the new ingest application privilege that replaces the legacy apm privilege
  • Shows two API key creation examples: an unrestricted key (all pipelines) and a pipeline-scoped key
  • Notes backward compatibility for apm application keys
  • I've also updated the elasticsearch-specification repo in this PR

Context

Managed Inputs (mOTLP) is introducing a new ingest application privilege to support pipeline-scoped authorization. See elastic/ingest-dev#6488. The reference doc currently has no section on authentication or how to create API keys programmatically — this fills that gap.

relates to #6489

Documents the new `ingest` application privilege for Managed Inputs
(mOTLP), including examples for creating unrestricted and pipeline-scoped
Elasticsearch API keys.
@alexandra5000 alexandra5000 requested review from a team and theletterf as code owners March 26, 2026 15:23
@alexandra5000 alexandra5000 marked this pull request as draft March 26, 2026 15:25
alexandra5000 and others added 2 commits March 27, 2026 10:50
Use full https:// URL instead of relative path for the Elasticsearch
create API key API reference link.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

### Create an API key for {{motlp}}

You can create an API key from the {{kib}} UI or using the {{es}} [create API key API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-create-api-key).
Copy link
Copy Markdown
Collaborator Author

@alexandra5000 alexandra5000 Mar 27, 2026

Choose a reason for hiding this comment

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

For some reason the typical docs link kept failing? URL works, so I left it like that for now.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think it's because this is the API docs.

@alexandra5000 alexandra5000 marked this pull request as ready for review March 27, 2026 13:49
}
```

#### Pipeline-scoped key
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I suggest putting this and the previous section in dropdowns.

Copy link
Copy Markdown
Member

@theletterf theletterf left a comment

Choose a reason for hiding this comment

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

Could this information go inside the ../_snippets/find-motlp-endpoint.md ?

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.

2 participants