कुञ्जीप्रबन्धनम्। लघुटिप्पणीधर्मे (१८ अक्टो) लेखः। अत्र यन्त्रप्रवेशः कुञ्ज्या। API key, scope, rotate। न god-key; कुञ्जीधर्मः।
English (minimizable)
After structured logging (18 Oct), this post covers API keys: one-time display, hashed storage, scopes, dual-key rotation, per-key limits, leak revoke, inventory, browser anti-patterns and audit.
पूर्ण-शीर्षकम् / Full title
कुञ्जीप्रबन्धनम्: A Metrical Codification of API Key Management (with English glosses)
English · overview and topics (minimizable)
What this post is about
API keys are shared secrets for machine clients. They need the same lifecycle discipline as other credentials.
Topics covered
- Machine auth use case
- Show-once + hash at rest
- Scoped keys and env split
- Zero-downtime rotation
- Per-key rate limits
- Leak scanning and revoke
- Owner and last-used inventory
- Not for SPAs
- Audit events
- Links to secrets sessions OAuth
Sanskrit title
कुञ्जीप्रबन्धनम् = kuñjī-prabandhanam “key management”.
English
Minimizable; Sanskrit-first.
परम्परा-सन्धिः / Series links
| पूर्वं / Prior | अत्र / Adds | न पुनः / Does not repeat |
|---|---|---|
| रहस्यप्रबन्धनम् (१९ जुलै) | vaulting secrets | API key species |
| सीमादरः (१३ अगस्त) | rate limits | per-key quotas |
| लेखापरीक्षापथः (२१ सितम्बे) | audit | key lifecycle events |
| प्राप्याधिकारप्रवाहः (८ अक्टो) | OAuth | human vs machine |
| इदम् | API key lifecycle | - |
ग्राह्य-त्याज्य-विवेकः / Keep and avoid
ग्राह्यम् / Keep
१. hash at rest: no retrieve plaintext
२. narrow scopes: env separated
३. overlap rotation: two keys valid
४. per-key limits: noisy integration fence
५. inventory: owner last_used
६. fast revoke: runbook
७. no keys in frontend: use user tokens
त्याज्यम् / Avoid
- store API keys in git
- one production key for all partners
- no revoke path
अध्याय-योजना / Chapter plan
| प्रकरणम् | विषयः | छन्दः | श्लोकाः |
|---|---|---|---|
| १ | मङ्गलं बीजं च / Opening | अनुष्टुभ् | २ |
| २ | मूलतत्त्वानि / Core | अनुष्टुभ् | २ |
| ३ | मुख्यविधिः / Method | उपजाति | १ |
| ४ | रक्षा · विधिः / Guards | अनुष्टुभ् | २ |
| ५ | विवेक · सीमा / Judgment | अनुष्टुभ् | २ |
| ६ | पूर्वसन्धिः / Series links | उपजाति | १ |
| ७ | उपसंहारः / Close | अनुष्टुभ् | २ |
पारिभाषिक-कोशः / Glossary
| Modern English | संस्कृतम् | Note |
|---|---|---|
| API key | APIकुञ्जी / यन्त्रकुञ्जी | |
| key hash | कुञ्जीसारांशः | |
| key rotation | कुञ्जीभ्रमणम् | |
| key scope | कुञ्जीक्षेत्रम् | |
| revoke | विच्छेदः | |
| key inventory | कुञ्जीसूची | |
| prefix key | उपसर्गकुञ्जी | lookup aid |
| customer key | ग्राहककुञ्जी | |
| service account | सेवाखाता | related |
| secret scan | गुह्यस्कैन |
श्लोकः १ (अनुष्टुभ्)
कुञ्जीप्रबन्धनं तस्माद् मितप्रवेशः ॥१॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
यन्त्रग्राहके गुह्यं यदि passwordवत् तदा APIकुञ्जी ।
कुञ्जीप्रबन्धनं तस्माद् मितप्रवेशः ॥१॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| यन्त्रग्राहके | in machine client |
| गुह्यम् | secret |
| passwordवत् | like password |
| APIकुञ्जी | API key |
| कुञ्जीप्रबन्धनम् | key management |
| मितप्रवेशः | measured entry |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| APIकुञ्जी | API key |
| मितप्रवेशः | measured access |
English sense
API keys authenticate non-human clients. They are long-lived secrets and need inventory rotation and scope like other credentials.
Context / topic
Topic: why API keys.
वृत्तमिति: ८-८-८-८।
श्लोकः २ (अनुष्टुभ्)
plaintext पुनः मा पश्य ॥२॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
दर्शयैकवारं संचये hash ।
plaintext पुनः मा पश्य ॥२॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| दर्शयैकवारम् | show once |
| संचये | in store |
| hash | hash |
| plaintext | plaintext |
| पुनः | again |
| मा पश्य | do not see |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| संचये hash | store hash |
| plaintext | cleartext key |
English sense
Show the raw key once at creation; store only a hash (or KMS-wrapped form). Operators should not retrieve plaintext later.
Context / topic
Topic: storage.
वृत्तमिति: ८-८-८-८।
श्लोकः ३ (अनुष्टुभ्)
एकuniversal key भये ॥३॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
scope prefix environment लेख्यम् ।
एकuniversal key भये ॥३॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| scope | scope |
| prefix | prefix |
| environment | environment |
| लेख्यम् | documented |
| एकuniversal | one universal |
| key | key |
| भये | in danger |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| scope | permission scope |
| universal key | one key for all |
English sense
Scope keys narrowly (read-only payments-only) and separate prod from dev. A single god key is a single breach.
Context / topic
Topic: least privilege. Links to IAM.
वृत्तमिति: ८-८-८-८।
श्लोकः ४ (अनुष्टुभ्)
सहसान्त्ये client भग्नाः ॥४॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
rotation without downtime dual accept ।
सहसान्त्ये client भग्नाः ॥४॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| rotation | rotation |
| without | without |
| downtime | downtime |
| dual | dual |
| accept | accept |
| सहसा | sudden |
| अन्त्ये | end |
| client | client |
| भग्नाः | broken |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| dual accept | old+new valid |
| सहसान्त्ये | sudden cut |
English sense
Support overlapping validity so clients can swap keys without a flag day.
Context / topic
Topic: rotation.
वृत्तमिति: ८-८-८-८।
श्लोकः ५ (उपजाति)
quota per key ।
कोलाहलिन्
एककुञ्ज्या ॥५॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
rate limit per key
quota per key ।
कोलाहलिन्
एककुञ्ज्या ॥५॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| rate | rate |
| limit | limit |
| per | per |
| key | key |
| quota | quota |
| कोलाहलिन् | noisy neighbor |
| एककुञ्ज्या | via one key |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| per key | keyed limits |
| कोलाहलिन् | noisy neighbor |
English sense
Apply rate limits and quotas per key so one integration cannot starve others. Ties to rate-limit and tenancy.
Context / topic
Topic: per-key limits.
सन्धिः: सीमादरः + बहुकिरायः.
वृत्तमिति: एकादशाक्षराः पादाः।
श्लोकः ६ (अनुष्टुभ्)
scan + revoke शीघ्रम् ॥६॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
leak path git logs tickets ।
scan + revoke शीघ्रम् ॥६॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| leak | leak |
| path | path |
| git | git |
| logs | logs |
| tickets | tickets |
| scan | scan |
| revoke | revoke |
| शीघ्रम् | quickly |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| leak path | where keys escape |
| revoke | invalidate |
English sense
Scan repos and tickets for accidental keys; make revoke a one-click runbook.
Context / topic
Topic: leak response. Links to supply chain secrets.
वृत्तमिति: ८-८-८-८।
श्लोकः ७ (अनुष्टुभ्)
अनाथकुञ्जी वनम् ॥७॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
last_used created_by inventory ।
अनाथकुञ्जी वनम् ॥७॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| last_used | last_used |
| created_by | created_by |
| inventory | inventory |
| अनाथकुञ्जी | orphan key |
| वनम् | forest |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| last_used | usage timestamp |
| अनाथकुञ्जी | orphan keys |
English sense
Maintain inventory with owner and last-used; expire idle keys.
Context / topic
Topic: inventory hygiene.
वृत्तमिति: ८-८-८-८।
श्लोकः ८ (अनुष्टुभ्)
browser मा key नित्यम् ॥८॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
user password ≠ API key UX ।
browser मा key नित्यम् ॥८॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| user | user |
| password | password |
| API | API |
| key | key |
| UX | UX |
| browser | browser |
| मा | do not |
| key | key |
| नित्यम् | always |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| browser | frontends |
| key नित्यम् | key forever in JS |
English sense
Do not put long-lived API keys in SPAs. Prefer OAuth user flows or short backend-minted tokens.
Context / topic
Topic: browser misuse. Links to OAuth.
वृत्तमिति: ८-८-८-८।
श्लोकः ९ (अनुष्टुभ्)
बिना लेखाद विवादः ॥९॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
audit who created rotated revoked ।
बिना लेखाद विवादः ॥९॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| audit | audit |
| who | who |
| created | created |
| rotated | rotated |
| revoked | revoked |
| बिना लेखाद | without record |
| विवादः | dispute |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| audit | audit trail |
| revoked | revocations |
English sense
Key lifecycle events belong in the audit path treatise.
Context / topic
Topic: audit. Links to audit trail (21 Sep).
वृत्तमिति: ८-८-८-८।
श्लोकः १० (उपजाति)
कुञ्जी तस्य जातिः ।
सत्रं तु
जनस्मृतिः ॥१०॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
रहस्यप्रबन्धनं कोशः
कुञ्जी तस्य जातिः ।
सत्रं तु
जनस्मृतिः ॥१०॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| रहस्यप्रबन्धनम् | secrets treatise |
| कोशः | vault |
| कुञ्जी | key |
| तस्य | its |
| जातिः | species |
| सत्रम् | session |
| तु | but |
| जनस्मृतिः | human memory |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| रहस्यप्रबन्धनम् | secrets mgmt |
| सत्रम् | session |
English sense
API keys are a species of secret for machines; sessions remember humans. Different lifecycle same care.
Context / topic
Topic: secrets vs sessions.
सन्धिः: रहस्यं जातिः; कुञ्जी यन्त्रप्रवेशः।
वृत्तमिति: एकादशाक्षराः पादाः।
श्लोकः ११ (अनुष्टुभ्)
एभिः कुञ्जीप्रबन्धनं मितप्रवेशसमन्वितम् ॥११॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
hash scope rotate inventory revoke पञ्चकम् ।
एभिः कुञ्जीप्रबन्धनं मितप्रवेशसमन्वितम् ॥११॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| hash | hash |
| scope | scope |
| rotate | rotate |
| inventory | inventory |
| revoke | revoke |
| पञ्चकम् | five-set |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| पञ्चकम् | hash scope rotate inventory revoke |
English sense
Five limbs: hashed storage, narrow scope, overlap rotation, owner inventory and fast revoke.
Context / topic
Topic: checklist.
वृत्तमिति: ८-८-८-८।
श्लोकः १२ (अनुष्टुभ्)
मितं गुह्यं क्रियायोग्यं तन्त्रधर्मः स उच्यते ॥१२॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
इति कुञ्जीप्रबन्धनसारो मितप्रवेशसमन्वितः ।
मितं गुह्यं क्रियायोग्यं तन्त्रधर्मः स उच्यते ॥१२॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| इति | thus |
| कुञ्जीप्रबन्धनसारः | key-mgmt essence |
| मितप्रवेशः | measured entry |
| मितम् | measured |
| गुह्यम् | secret |
| क्रियायोग्यम् | operable |
| तन्त्रधर्मः | system dharma |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| मितं गुह्यम् | measured secret |
| तन्त्रधर्मः | platform dharma |
English sense
Closing: mint fewer keys, scope them tightly and kill them when they leak or sleep.
Context / topic
Topic: close.
उपसंहारन्यायः: एकवारं दर्शय; hash रक्ष; काले विघटय।
वृत्तमिति: ८-८-८-८।
श्लोकसूची / Verse index
१. Why keys
२. Store hash
३. Scope
४. Rotate
५. Per-key limits
६. Leak/revoke
७. Inventory
८. Not in browser
९. Audit
१०. Secrets link
११. Five limbs
१२. Close
सन्दर्भाः / References
- Prior: secrets 2026-07-19; rate limit 2026-08-13; audit 2026-09-21; OAuth 2026-10-08.
- Domain: API key lifecycle management.
- English minimizable; Sanskrit-first.
- Style: no em dash; no Oxford comma in English clauses.