# Access and permissions Who sees what in Atlas, and why an item can be missing for you while a colleague has it. ```{figure} ../images/reference-tables/admin.png :class: screenshot :alt: The Atlas sidebar of an admin on an engine with versioning, next to the Admin page The sidebar of an admin on an engine with versioning, and the Admin page. ``` | | What it is | |---|---| | [1]{.callout} **Versioning** | Listed only when versioning is available to you (see [below](#access-versioning)). Its count is the number of open reviews. | | [2]{.callout} **Git remote** | Listed with **Versioning**. Its settings apply to the whole tenant. | | [3]{.callout} **API access** | Everyone signed in. API clients of your tenant. | | [4]{.callout} **Admin** | Only for admins. | | [5]{.callout} You | Your user name, `tenant: `, and **Sign out**. | | [6]{.callout}–[9]{.callout} | The Admin page: **HTML Email Path**, **Actually send (uncheck to dry run)**, **Send Update Mail**, **Send Test Mail** ([see below](#access-admin)). | (access-sign-in)= ## Signed in, and your tenant You sign in with your openFHIR account; **Login** sends you to the sign-in page. Your account belongs to one **tenant**, shown under your name in the sidebar. Everything Atlas shows and changes is your tenant's: templates, model and context mappers, ConceptMaps, FHIR packages, insights, API clients and the versioning settings. Other tenants on the same engine never see them, and you never see theirs. Atlas acts on the engine **as you**: it passes your sign-in to the engine with every request. What the engine lets your account do (its scopes) is therefore what you can do in Atlas. When the engine refuses something, Atlas shows the engine's message. **Sign out** (the arrow next to your name) ends your Atlas session and your sign-in. (access-demo-user)= ## Demo user When you aren't signed in, the sidebar footer reads: > You're exploring **openFHIR Atlas** as a demo user. Sign up for individual access to unlock additional features. with **Login** and, where sign-up is offered, **Sign up**. Signing up gives you your own account and tenant on that environment; see {doc}`/offer/ways-to-use`. (access-public-demo)= ## The public demo The public demo is an Atlas run in *public mode*. In this mode Atlas doesn't pass anyone's sign-in to the engine: it calls the engine with one service account of its own. As a result: - Everyone using the demo works on the same engine state, as the same engine user. Don't put anything private in it. - **Versioning** and **Git remote** are not listed. Pages that need versioning say "Versioning is not available in the public demo." The engine's history would credit every change to the service account instead of to the person who made it, so Atlas turns versioning off rather than record wrong authors. - There is no Admin page. For your own isolated workspace, use the sandbox or a licensed installation ({doc}`/offer/ways-to-use`). (access-admin)= ## Admin **Admin** appears under **Settings** only for users with the `admin` role in the openFHIR sign-in service (Keycloak). Anyone else who opens `/admin` lands on **Engine state**. The Admin page has one tool, **Send Sandbox Update Mail**, for the people who run the openFHIR sandbox: | Control | What it does | |---|---| | **HTML Email Path** | A path to an HTML file **on the Atlas server** with the mail's content. `::USER::` in the file is replaced per recipient. | | **Actually send (uncheck to dry run)** | Off: **Send Update Mail** only lists who would get the mail ("Would send mail to
(user: )"). On: it sends. | | **Send Update Mail** | Mails every enabled sandbox API client whose name is an e-mail address and that belongs to a tenant ("Sent mail to
(user: )"). | | **Send Test Mail** | Sends the mail once to the maintainers' fixed test address, whatever the checkbox says, and answers "Sent". | If the file can't be read, the list ends with "EXCEPTION" and the reason. (access-versioning)= ## Versioning: who can read and who can write Versioning (history, blame, reviews, releases, the Git remote) is offered when all of these hold: | Situation | What you see instead | |---|---| | The engine versions mappings. | "This openFHIR engine does not version mappings. Git versioning needs openFHIR Enterprise." | | Your account may read the history: the engine scope `versioning.r`. | "Your account may not read the version history (scope versioning.r)." | | Atlas isn't the public demo. | "Versioning is not available in the public demo." | | The engine can be reached. | "The openFHIR engine could not be reached." | When one of these doesn't hold, **Versioning** and **Git remote** are missing from the sidebar, and the History tab of the Workspace's dock isn't there. {doc}`/ship/index` explains each case. Reading needs `versioning.r`. Changing anything (the Git remote settings, connecting, pushing, checkpoints, reviews and releases) needs `versioning.w`. Restoring a version or pulling also changes the mappings themselves, so it needs the engine's `fc`, `opt` and `conceptmap` write scopes as well. The full list is in {external+openfhir:doc}`authentication`. (access-git-remote)= ## The Git remote is shared by the whole tenant There is one Git remote configuration per tenant. The Git remote page says so: > These settings apply to the whole tenant . Everyone who signs in to it pushes to this > repository and branch with this token, and a change here changes it for all of them. So the access token you enter there is used for everyone's pushes, and anyone with `versioning.w` in your tenant can change or disconnect it. Agree on one owner before you change it. See {doc}`/ship/git-remote`. (access-api-clients)= ## API clients **API access** lists the API clients of your tenant ("No API clients found for your tenant." when there are none). **Generate Client** creates one named after your user. A client signs in on its own with the client-credentials flow (**Get Token**), so your systems can call the engine without a person. A generated client gets these scopes: | Scope | Lets the client | |---|---| | `openfhir.map` | Convert: `$tofhir` and `$toopenehr`. | | `openfhir.insights` | Read mapping insights. | | `fc.c`, `fc.r`, `fc.u`, `fc.d` | Create, read, update and delete model and context mappers. | | `opt.c`, `opt.r`, `opt.u`, `opt.d` | Create, read, update and delete operational templates. | | `conceptmap.c`, `conceptmap.r`, `conceptmap.u`, `conceptmap.d` | Create, read, update and delete ConceptMaps. | It doesn't get the FHIR package (`fhirpackage.*`) or versioning (`versioning.*`) scopes. The client works only on your tenant's data, like you. **Delete** removes it (after a confirmation). {doc}`/operate/connect-api` walks through it; the engine's REST API is described in {external+openfhir:doc}`restful_apis`. :::{warning} Treat a client secret like a password: anyone holding it can change your tenant's mappings. **Copy Secret** puts it on your clipboard; don't paste it into tickets or chat. ::: ## Related - {doc}`/start/before-you-start` - {doc}`/offer/ways-to-use` - {doc}`/reference/screens/api-access` - {doc}`/reference/screens/git-remote`