The SmartLabSys platform

Integrations

The SmartLabSys platform

SmartLIMS is one of several SmartLabSys apps. The SmartLabSys platform is the shared hub where your organization, your people and their sign-in live. This page explains what the platform does for SmartLIMS and what stays inside SmartLIMS.

Who this is for: Laboratory owners and administrators · You need: an owner or admin account on the SmartLabSys platform, and the Owner role in SmartLIMS

The idea in short

The SmartLabSys platform (platform.smartlabsys.com) holds three things:

  • Accounts: one account per person, with email verification, password reset, two-factor sign-in (an authenticator app, with recovery codes), passkeys and a list of active sessions.
  • Organizations: your organization, its members and their platform roles (owner, admin, member), and invitations for new members.
  • App connections: which SmartLabSys apps your organization uses, and which people may use each app.

SmartLIMS holds everything about your lab work: requests, samples, work orders, results, customers, settings and the audit trail. Lab data never moves to the platform.

Lives on the platform Lives in SmartLIMS
Your account, password, two-factor sign-in, passkeys Your requests, samples, work orders and results
Your organization and its members Your company, laboratories and departments
Which people may use SmartLIMS Detailed permissions inside SmartLIMS (roles)
Connections to other apps Forms, products, parameters, rulebooks and all other settings

One organization, one company

When your organization is connected to SmartLIMS, it becomes one SmartLIMS company.

  • If the person making the connection already owns a SmartLIMS company with the same email address, the organization is linked to that company. Nothing in it changes.
  • Otherwise SmartLIMS creates a new company for you. It is approved straight away and starts with three roles: Owner (all permissions), Member and a system role used by SmartLIMS itself.

Who gets in, and with which role

On the platform you choose which members may use SmartLIMS and give each one an app role. SmartLIMS receives that list automatically.

Platform app role What it means in SmartLIMS
Owner The person gets the company's Owner role, with every permission.
Member The person can use SmartLIMS. If they were Owner before, they move down to Member. If you gave them a custom role inside SmartLIMS, they keep it.

The platform only decides who may use SmartLIMS and whether they are an owner. The detailed permissions (who may verify results, who may manage forms, and so on) are set inside SmartLIMS. See Users, roles and permissions.

How to sign in with the platform

  1. Open the SmartLIMS sign-in page.
  2. Click Sign in with Smartlab. This button only shows when your SmartLIMS installation is connected to the platform.
  3. Sign in on the platform page, if you aren't signed in there already.
  4. You come back to SmartLIMS, signed in to your company.

📷 Screenshot: the SmartLIMS sign-in page with the email and password fields, the word "or", and the Sign in with Smartlab button

The first time you sign in this way, SmartLIMS finds you by your platform account. If there is none yet, it looks for a user with your verified email address in your company and links the two. If there is still no match, it creates your user.

A user created through the platform has no SmartLIMS password, so they always sign in with Sign in with Smartlab. SmartLIMS has no screen for setting or changing a password yet.

Platform sign-in doesn't replace the normal sign-in. Users with a SmartLIMS password can still sign in with their email and password. See Signing in and finding your way.

How to connect your organization to SmartLIMS

  1. Sign in to the platform as an owner or admin of your organization.
  2. Start the app connection wizard and choose SmartLIMS.
  3. Finish the wizard. SmartLIMS links or creates your company (see "One organization, one company" above).
  4. On the platform, assign SmartLIMS to the members who need it, with the Owner or Member app role.
  5. Ask those people to sign in with Sign in with Smartlab.
  6. In SmartLIMS, open Settings › Roles and fine-tune what Members may do, if the default Member role doesn't fit. See Users, roles and permissions.

📷 Screenshot: the platform's app connection wizard with SmartLIMS selected

What happens when things change on the platform

On the platform you… In SmartLIMS
Assign SmartLIMS to a member The person can sign in with Sign in with Smartlab.
Change a member's app role Their SmartLIMS role is updated (see the table above).
Remove a member from SmartLIMS Their SmartLIMS user is deactivated. The user record stays, because requests and the audit trail refer to it.
Sign out on the platform Their SmartLIMS sessions end too.
Suspend the SmartLIMS connection The company is deactivated. Nobody can sign in, and they see "Your company's access is currently suspended. Please contact your administrator."
Resume the connection The company is active again, and people can sign in.
Remove the connection completely The company is unlinked and deactivated, together with its users. Your lab data is kept in SmartLIMS.

Messages you may see

Message What to do
Your Smartlab sign-in took too long or was already used. Please try again. Click Sign in with Smartlab again.
Smartlab sign-in was cancelled or you have no access to this app. Ask your organization's owner or admin to assign SmartLIMS to you on the platform.
Signing in with Smartlab failed. Please try again. Try again. If it keeps failing, contact SmartLabSys support.
Your company's access is currently suspended. Please contact your administrator. Your organization's SmartLIMS connection is suspended. Ask your owner or admin.
Your account has been deactivated. Please contact your administrator. Your user was removed from SmartLIMS or deactivated. Ask your owner or admin.

Limits to know about

  • One company per email address. An email address can belong to only one SmartLIMS company. A person who already has a user in another SmartLIMS company can't sign in to yours with the same address.
  • SmartQC uses its own connection. The link between SmartLIMS and SmartQC is set up with an access key from SmartQC, not through the platform. See SmartQC.
  • Financial needs the platform. The connection to Financial is made through the platform. See Financial (invoicing).

Tips

  • Give the Owner app role to as few people as possible. Everyone else can be a Member, with the right permissions set in SmartLIMS.
  • Removing someone on the platform is the cleanest way to take away their access. Their name stays on the work they did.
  • The app switcher in the SmartLIMS menu takes you to the other SmartLabSys apps your organization uses.
↑↓ to move ↵ to open esc to close