{"title":"Principals","description":"Manage Altertable principals for people and automation so access to organizations, environments, and data stays governed.","order":200,"askSuggestions":["When should I use a service account instead of a personal login?","How do I scope a service account to a single catalog?","How do I give automation access to the Management API?"],"navigation":true,"body":{"code":"var Component=(()=>{var u=Object.create;var a=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,v=Object.prototype.hasOwnProperty;var y=(o,e)=>()=>(e||o((e={exports:{}}).exports,e),e.exports),b=(o,e)=>{for(var t in e)a(o,t,{get:e[t],enumerable:!0})},s=(o,e,t,i)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let r of g(e))!v.call(o,r)&&r!==t&&a(o,r,{get:()=>e[r],enumerable:!(i=m(e,r))||i.enumerable});return o};var w=(o,e,t)=>(t=o!=null?u(f(o)):{},s(e||!o||!o.__esModule?a(t,\"default\",{value:o,enumerable:!0}):t,o)),I=o=>s(a({},\"__esModule\",{value:!0}),o);var d=y((k,l)=>{l.exports=_jsx_runtime});var A={};b(A,{default:()=>p,frontmatter:()=>x});var n=w(d()),x={title:\"Principals\",description:\"Manage Altertable principals for people and automation so access to organizations, environments, and data stays governed.\",order:200,askSuggestions:[\"When should I use a service account instead of a personal login?\",\"How do I scope a service account to a single catalog?\",\"How do I give automation access to the Management API?\"]};function h(o){let e={a:\"a\",h1:\"h1\",h2:\"h2\",li:\"li\",p:\"p\",strong:\"strong\",ul:\"ul\",...o.components},{DocsPreviewDocument:t,DocsPreviewSection:i,DocsTable:r}=e;return t||c(\"DocsPreviewDocument\",!0),i||c(\"DocsPreviewSection\",!0),r||c(\"DocsTable\",!0),(0,n.jsxs)(t,{anchors:\"principals principal-types service-accounts learn-more\",children:[(0,n.jsxs)(i,{sectionId:\"principals\",anchors:\"\",ancestors:\"\",index:\"0\",children:[(0,n.jsx)(e.h1,{id:\"principals\",children:\"Principals\"}),`\n`,(0,n.jsx)(e.p,{children:\"Principals are identities that can be granted access in Altertable. A principal can be a person using the app or a service account used by automation.\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Altertable applies the same \",(0,n.jsx)(e.a,{href:\"/docs/administration/access-control\",children:\"access control\"}),\" model to both types: assign roles at the organization, environment, or catalog level depending on how much access the principal needs.\"]}),`\n`]}),(0,n.jsxs)(i,{sectionId:\"principal-types\",anchors:\"\",ancestors:\"\",index:\"1\",children:[(0,n.jsx)(e.h2,{id:\"principal-types\",children:\"Principal types\"}),`\n`,(0,n.jsx)(r,{columns:[\"Type\",\"Use for\",\"Managed from\"],data:[{Type:\"Team member\",\"Use for\":\"Humans who log in to the Altertable app\",\"Managed from\":\"Organization settings\"},{Type:\"Service account\",\"Use for\":\"Automation such as CI, dbt jobs, scripts, and machine-to-machine access\",\"Managed from\":\"Organization settings\"}]}),`\n`]}),(0,n.jsxs)(i,{sectionId:\"service-accounts\",anchors:\"\",ancestors:\"\",index:\"2\",children:[(0,n.jsx)(e.h2,{id:\"service-accounts\",children:\"Service accounts\"}),`\n`,(0,n.jsx)(e.p,{children:\"Use service accounts instead of shared human accounts for scheduled jobs and integrations. They make ownership clearer, can be scoped narrowly, and can be rotated without affecting a person's login.\"}),`\n`,(0,n.jsx)(e.p,{children:\"Typical uses include:\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsx)(e.li,{children:\"Running ingestion or transformation jobs.\"}),`\n`,(0,n.jsx)(e.li,{children:\"Connecting BI tools or scripts.\"}),`\n`,(0,n.jsx)(e.li,{children:\"Managing deployments that need API or lakehouse credentials.\"}),`\n`,(0,n.jsx)(e.li,{children:\"Giving an AI client or workflow access to a specific environment or catalog.\"}),`\n`]}),`\n`,(0,n.jsxs)(e.p,{children:[\"Use the \",(0,n.jsx)(e.a,{href:\"/docs/lakehouse/clients/cli\",children:\"CLI\"}),\" to test a service account profile from a terminal before wiring it into CI.\"]}),`\n`,(0,n.jsx)(e.p,{children:\"After creating a service account, review its roles before using it in production. Prefer catalog-level or environment-level access when the job does not need the full organization.\"}),`\n`,(0,n.jsx)(e.p,{children:\"Issue a management API key for a service account when automation needs the Management API. The key acts as that service account, so its requests use the same role assignments and resource scope. Store the key in a secret manager and rotate it independently of human credentials.\"}),`\n`]}),(0,n.jsxs)(i,{sectionId:\"learn-more\",anchors:\"\",ancestors:\"\",index:\"3\",children:[(0,n.jsx)(e.h2,{id:\"learn-more\",children:\"Learn more\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:(0,n.jsx)(e.a,{href:\"/docs/administration/access-control\",children:\"Access control\"})}),\": role scopes and recommended patterns.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:(0,n.jsx)(e.a,{href:\"/docs/administration/lakehouse-credentials\",children:\"Authentication\"})}),\": credentials for querying the lakehouse.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:(0,n.jsx)(e.a,{href:\"/docs/agents/mcp\",children:\"MCP\"})}),\": Governed agent access to interact with your lakehouse.\"]}),`\n`]})]})]})}function p(o={}){let{wrapper:e}=o.components||{};return e?(0,n.jsx)(e,{...o,children:(0,n.jsx)(h,{...o})}):h(o)}function c(o,e){throw new Error(\"Expected \"+(e?\"component\":\"object\")+\" `\"+o+\"` to be defined: you likely forgot to import, pass, or provide it.\")}return I(A);})();\n;return Component;"},"_id":"docs/administration/principals.mdx","_raw":{"sourceFilePath":"docs/administration/principals.mdx","sourceFileName":"principals.mdx","sourceFileDir":"docs/administration","contentType":"mdx","flattenedPath":"docs/administration/principals"},"type":"Docs","path":"/administration/principals","level":2,"parent":"administration"}