K-Dense-AI/scientific-agent-skills / skills/labarchive-integration
labarchive-integration
VerifiedIntegrates with the official LabArchives ELN REST-like API and Inventory API v1. Supports regional endpoint selection, signed-request construction, user authorization and UID flows, local LA container validation, and verified LabArchives integration workflows.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.5 KB |
| references/api_reference.md | markdown | 12.7 KB |
| references/authentication_guide.md | markdown | 9.4 KB |
| references/integrations.md | markdown | 6.8 KB |
| references/sources.md | markdown | 11.0 KB |
| scripts/entry_operations.py | script | 12.8 KB |
| scripts/notebook_operations.py | script | 15.3 KB |
| scripts/setup_config.py | script | 8.5 KB |
references/authentication_guide.md
View on GitHub# LabArchives Authentication and Regions
Verified against official public sources on **2026-09-30**. LabArchives may
provide additional institution-specific development documentation with API
credentials; that documentation controls when it differs from this summary.
## Access prerequisites
### ELN
The official ELN subscription guide (updated 2026-08-27) lists developer API
access as an Enterprise capability. An Access Key ID and Access Password are
issued by LabArchives for a specific organization/vendor and intended purpose.
They are not ordinary account credentials.
Official source:
https://help.labarchives.com/hc/en-us/articles/11723701830676-ELN-for-Research-Introduction-and-Subscription-Plans
### Inventory API v1
The Inventory FAQ (updated 2026-05-19) states that API access is available only
to Enterprise and Enterprise Plus licensees. The caller must:
- have a LabArchives account,
- have an Inventory account,
- be given API access, and
- remain subject to Inventory application access rights.
An eligible Inventory license member can request access through
`support@labarchives.com`.
Official source:
https://help.labarchives.com/hc/en-us/articles/11811035048212-Inventory-FAQs
## Credential types
Keep these values distinct:
- **Access Key ID (`akid`)** — identifies the API client.
- **Access Password** — secret HMAC-SHA-512 key; it is never sent as an API
parameter or request-body field.
- **UID** — user ID scoped to the Access Key ID that obtained it. It is
persistent until revoked, but it is not portable across API keys.
- **Authorization code** — short-lived value returned by the API user-login
flow and redeemed promptly through `users::user_access_info`.
- **Temporary password token** — user-generated alternative accepted as the
`password` parameter by `users::user_access_info`.
- **Inventory Lab ID** — identifies the current Inventory lab and is documented
as `X-LabArchives-LabId`; the `/public/v1/users/me` bootstrap endpoint does
not require this header and ignores it if supplied.
Do not use a normal LabArchives account password in API scripts.
## Regional browser and ELN API hosts
The two host types are intentionally shown in separate columns. Login URLs come
from the help-center SSO article updated **2025-11-04**; API URLs come from the
official ELN API overview updated **2025-11-03**.
| Region | Browser login | ELN API URL |
|---|---|---|
| US and rest of world | `https://mynotebook.labarchives.com` | `https://api.labarchives.com/api` |
| Canada | `https://ca-mynotebook.labarchives.com` | `https://caapi.labarchives.com/api` |
| Australia/New Zealand | `https://au-mynotebook.labarchives.com` | `https://auapi.labarchives.com/api` |
| United Kingdom | `https://uk-mynotebook.labarchives.com` | `https://ukapi.labarchives.com/api` |
| Europe outside the UK | `https://eu-mynotebook.labarchives.com` | `https://euapi.labarchives.com/api` |
Official sources:
- https://help.labarchives.com/hc/en-us/articles/11728160845332-Using-an-Institutional-Single-Sign-on-for-LabArchives-Access
- https://mynotebook.labarchives.com/share/LabArchives%20API/NS4yfDI3LzQvVHJlZU5vZGUvMTF8MTMuMg
The official ELN overview recommends `utilities::api_base_urls` for distributed
applications so they can discover future regional API additions. The bundled
validator intentionally pins the five hosts documented at this refresh date.
### Inventory absolute base URLs
The official notebook's **Inventory > Overview** publishes
`https://iapi.labarchives.com` as the base URL for current endpoints. Append the
exact `/public/v1/...` route. It specifies `Content-Type: application/json` for
requests; responses can be JSON or ZIP depending on the method. A regional
absolute base-URL table is not provided. Confirm any region-specific deployment
with LabArchives rather than deriving a host from a browser login URL.
### Inventory lab discovery
`GET /public/v1/users/me` explicitly does not require `X-LabArchives-LabId`
(and ignores it if supplied). Sign `/public/v1/users/me` and send the UID,
Access Key ID, signature, and expires headers. The JSON response contains
`userId`, `userName`, `status`, and `labs` entries with `labId` and `name`. Select
an authorized lab before issuing lab-scoped requests. The numeric Inventory
`userId` is not the Access-Key-scoped ELN UID used for authentication.
Official method page:
https://mynotebook.labarchives.com/share/LabArchives%20API/MTQ4LjIwMDAwMDAwMDAwMDAyfDI3LzExNC9UcmVlTm9kZS8zODc0Mjc0OTI5fDM3Ni4y
## Named environment variables
These names are conventions used by this skill's local helpers:
```text
LABARCHIVES_ELN_API_URL
LABARCHIVES_ACCESS_KEY_ID
LABARCHIVES_ACCESS_PASSWORD
LABARCHIVES_USER_ID
LABARCHIVES_INVENTORY_LAB_ID
```
Use a shell session, OS keychain, workload secret store, or institution-approved
secret manager to populate them. The scripts:
- inspect only these exact names,
- never walk parent directories for `.env`,
- never write secret files, and
- never print credential values.
Validate presence and endpoint selection:
```bash
uv run scripts/setup_config.py check
uv run scripts/setup_config.py check \
--require-user-id --require-inventory-lab-id
```
`--prompt-missing-secret` uses `getpass` for a missing Access Password and keeps
the value in memory only. It does not save or authenticate it.
## ELN API user authorization
The official page describes an **OAuth-like** redirect flow. It does not
document generic OAuth 2.0 client credentials, `/oauth/authorize`, or
`/oauth/token` endpoints.
1. Select the user's correct regional API host.
2. Redirect the user to the host's `/api_user_login` path with `akid`,
`expires`, `sig`, and `redirect_uri`.
3. For this special signature, use the exact **unencoded redirect URI** in place
of the normal API method name.
4. LabArchives performs account/SSO login and redirects back with `auth_code`
and `email`.
5. Promptly call the documented `users::user_access_info`, passing the
authorization code as its `password` parameter and the returned email as
`login_or_email`. The method uses GET query parameters, so redact the whole
query and any echoed authentication fields in the XML response.
6. Store the resulting UID only in approved secure state. It remains bound to
the Access Key ID and can be revoked. Respect `<auto-login-allowed>` and
institutional restrictions; `user_info_via_id` documents `authenticated=true`
only for an explicit user request to extend the session.
If redirects cannot be used, the official flow allows a user-generated
temporary password token in the same `password` parameter. Handle it with
`getpass` or a secure UI field; never put it on a command line or in a log.
Official user-login page (updated 2023-03-03):
https://mynotebook.labarchives.com/share/LabArchives%20API/ODEuOXwyNy82My05My9UcmVlTm9kZS8yMjYyMTU0MTg3fDIwNy44OTk5OTk5OTk5OTk5OA==
## Request signing
The official call-authentication page (updated 2023-05-10) defines:
```text
message = AccessKeyID + api_method_input + expires
signature = Base64(HMAC-SHA-512(key=AccessPassword, message=message))
```
There are no separators. `expires` is current epoch milliseconds, corrected for
server clock skew when needed—not a future token lifetime. The official page
allows two minutes for latency/minor clock synchronization, while the
best-practices page recommends `utilities::epoch_time` for unreliable clocks.
- **ELN ordinary call:** `api_method_input` is the method name only, without its
class.
- **ELN user-login redirect:** it is the unencoded redirect URI.
- **Inventory v1:** it is the exact relative route, including resolved path
parameters and excluding the query string.
Official signing page:
https://mynotebook.labarchives.com/share/LabArchives%20API/Ny44fDI3LzYvVHJlZU5vZGUvMTE1MzU5MTAyNXwxOS44
`GET /api/utilities/epoch_time` takes `akid` but does not require `sig` or
`expires`. Its XML `<epoch-time>` is epoch milliseconds. Cache a session clock
offset instead of calling this utility before every signature.
Use `scripts/entry_operations.py self-test` to check the implementation against
the official published test vector without credentials or network access.
## TLS and secret handling
- Permit only `https`.
- Never disable certificate or hostname validation.
- If an institutional interception proxy is required, use its approved CA
bundle and keep hostname verification enabled.
- Reject credentials embedded in URLs and reject redirects to unapproved hosts.
- Do not log full ELN URLs after signing; authentication appears in the query.
- Do not log Inventory authentication headers.
- Do not include the Access Password in query parameters, headers, form data, or
JSON. It is an HMAC key only.
- Rotate/revoke credentials through LabArchives after suspected exposure.
## Troubleshooting checklist
1. Confirm API access is enabled for the exact product and account.
2. Confirm the browser account and API host belong to the same region.
3. Confirm the UID was obtained with the same Access Key ID now in use.
4. Confirm the local clock or `epoch_time` adjustment.
5. Confirm the signing input: method-only for ELN, exact relative route for
Inventory, unencoded redirect URI for user login.
6. Confirm URL encoding is applied only after Base64 for the ELN `sig`.
7. Confirm Inventory path parameters are resolved and query parameters excluded
from its signature.
8. Report status, official API error code, and a redacted response to support.
Never include signatures, authorization codes, tokens, or passwords.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |