Skip to content

MTO Openbao extension adrs - #388

Closed
aayeshaarshad wants to merge 3 commits into
mainfrom
openbao-adrs
Closed

MTO Openbao extension adrs#388
aayeshaarshad wants to merge 3 commits into
mainfrom
openbao-adrs

Conversation

@aayeshaarshad

Copy link
Copy Markdown
Contributor

No description provided.

@aayeshaarshad
aayeshaarshad requested a review from a team as a code owner April 21, 2026 19:46

**Q2. Given namespace mode, what is the Tenant → OpenBao namespace mapping?** Two candidates:

- **1 Tenant = 1 OpenBao namespace** — the tenant's OpenBao namespace holds all of the tenant's k8s namespaces as paths and Kubernetes-auth roles inside it.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Consider removing “of” to be more concise (ALL_OF_THE[1])
Suggestions: all the
URL: https://languagetool.org/insights/post/wordiness/
Rule: https://community.languagetool.org/rule/show/ALL_OF_THE?lang=en-US&subId=1
Category: REDUNDANCY

@github-actions

Copy link
Copy Markdown

@aayeshaarshad PR doc deploy will soon be available for review on https://stakater.github.io/mto-docs/openbao-adrs

@github-actions

Copy link
Copy Markdown

@aayeshaarshad Image is available for testing. docker pull ghcr.io/stakater/mto-docs:SNAPSHOT-PR-388-286e7e73

@github-actions

Copy link
Copy Markdown

@aayeshaarshad PR doc deploy will soon be available for review on https://stakater.github.io/mto-docs/openbao-adrs

@github-actions

Copy link
Copy Markdown

@aayeshaarshad Image is available for testing. docker pull ghcr.io/stakater/mto-docs:SNAPSHOT-PR-388-08e7ccde

# Operator creates one key per k8s ns (name from layoutRef template),
# plus one `<tenant>-shared-<env>` key per tenant with >=2 namespaces
# (see Intra-tenant sharing).
keyType: aes256-gcm96 # aes256-gcm96 | chacha20-poly1305 | ed25519 | rsa-2048 | rsa-4096 | ecdsa-p256 | ...

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

- name: pki
type: pki
layoutRef: pkiMount
enabled: false # opt-in

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

intraTenantSharedRole: # materialized once per tenant with >=2 k8s ns (optional)
allowedDomains: ["*.{{ .tenant }}.svc.cluster.local"]
allowSubdomains: true
maxTTL: 720h

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

Always its own mount in both modes. One `OpenBao` CR can declare several (e.g. `pki-shared`, `pki-shared-partners`).

| `tenancy.mode=namespace` | `tenancy.mode=path` |
|---|---|

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Unpaired symbol: ‘"’ seems to be missing (EN_UNPAIRED_QUOTES)
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-parentheses
Rule: https://community.languagetool.org/rule/show/EN_UNPAIRED_QUOTES?lang=en-US
Category: PUNCTUATION

viewer: none

# transit:
# keyName: from-<W>-to-<R>-<env> # operator auto-fills if omitted

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
This word is normally spelled as one. (EN_COMPOUNDS_AUTO_FILLS)
Suggestions: autofills
Rule: https://community.languagetool.org/rule/show/EN_COMPOUNDS_AUTO_FILLS?lang=en-US
Category: MISC

spec:
engineRef: transit
from:
tenant: team-a

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: tenants
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC

spec:
engineRef: pki-shared
from:
tenant: platform

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Possible typo: you repeated a word (ENGLISH_WORD_REPEAT_RULE)
Suggestions: tenants
Rule: https://community.languagetool.org/rule/show/ENGLISH_WORD_REPEAT_RULE?lang=en-US
Category: MISC


| Field | Type | Required | Description |
|---|---|---|---|
| `keyName` | string | yes | Transit key to share. Created if absent. Naming convention: `from-<W>-to-<R>-<env>` for directional, `shared-all-<env>` for broadcast — operator auto-fills if omitted. |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
This word is normally spelled as one. (EN_COMPOUNDS_AUTO_FILLS)
Suggestions: autofills
Rule: https://community.languagetool.org/rule/show/EN_COMPOUNDS_AUTO_FILLS?lang=en-US
Category: MISC


In every `pki/` and `pki-<tenant>/` mount (inside any namespace), these
endpoints are on OpenBao's unauthenticated-paths list and do **not**
require a policy grant:

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Two consecutive dots (DOUBLE_PUNCTUATION)
Suggestions: .,
URL: https://languagetool.org/insights/post/punctuation-guide/#what-are-periods
Rule: https://community.languagetool.org/rule/show/DOUBLE_PUNCTUATION?lang=en-US
Category: PUNCTUATION

### `share-team-a-to-team-b-writer`

```hcl
path "kv/data/shared/dev/from-team-a/to-team-b/*" { capabilities = ["create","read","update"] }

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[LanguageTool] reported by reviewdog 🐶
Use a comma before ‘so’ if it connects two independent clauses (unless they are closely connected and short). (COMMA_COMPOUND_SENTENCE_2[1])
Suggestions: , so
URL: https://languagetool.org/insights/post/comma-before-and/
Rule: https://community.languagetool.org/rule/show/COMMA_COMPOUND_SENTENCE_2?lang=en-US&subId=1
Category: PUNCTUATION

@github-actions

Copy link
Copy Markdown

@aayeshaarshad PR doc deploy was successfully deleted from branch pull-request-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