Companies
A company within Assets | Lapine Studios contains all assets, users, and permissions tied to a logical entity. In an ideal deployment, a single company should represent an organisation. Allowances for assets, templates, inventories, actions, and users are calculated at a company level and companies cannot be related to one another.
There are very few use cases for an organisation to have more than one company. We strongly recommend that you use a single organisation for tracking your assets; using multiple companies runs the risk of assets no longer being unique, a core driving feature to use Assets.
Subscriptions
Companies may choose to increase their allowances within Assets by upgrading their subscription. Subscriptions can be created by any person with the Company Write permission. Assets uses Stripe as a payment processor. When creating a subscription, an account within Stripe is created and tied to the email address provided during payment.
The self-service management of the subscription, including cancellation, downgrading, and upgrading, must be performed using the Stripe account created during the initial subscription creation. For this reason, we recommend that an organisation-designated email address is used for the mangemenet of the Assets subscription in alignment with your organisation's service management policies.
Company Subscription Guides
Creating Subscriptions
Subscriptions for an Assets company can be managed by the Company Owner or anyone with the Company Write role. When creating a company it is very important to use a designated email address when completing the purchase within Stripe, as this email address will be required to manage the subscription to update or cancel using self-service. The following steps can be used to create a subscription within Stripe for Assets:
- Open the 'Manage' Company page within the Assets console.
- Click on the 'Create Subscription' button. This show the subscription options.
- Select the option you wish to upgrade to.
- Complete the transaction within Stripe. Make sure that the email address used to create the subscription is recorded and will remain accessible in the future for Assets subscription self-service events.
Newly created subscriptions should take effect immediately. If you do not see your subscription within half an hour, confirm that the transaction has been fully processed, then contact support@assets.lapine.studio.
Managing Subscriptions
Subscriptions can be managed using the Stripe account created during initial account setup. The following steps can be used to manage your subscription within Stripe from Assets:
- Open the 'Manage' Company page within the Assets console.
- Click on the 'Manage Subscription' button. This will redirect your browser to the Stripe customer portal for Assets.
- Enter the email address used to create the subscription on the Stripe customer portal.
- Use the email account to access the one-time access code and authenticate to the customer portal.
- Change, cancel, or otherwise manage the state of the subscription.
For subscription downgrades and cancellation, the current level of subscription will be applied until the end of the billing cycle. Subscription upgrades should be applied within half an hour.
Company Guides
How to Entra Single-Sign On Authentication
Assets supports user authentication with Entra through the use of an Entra Application Registration. The following steps can be used to configure Assets to allow authentication using your Entra user accounts:
-
Create an Application Registration within Entra with the following configuration:
- [Recommended] Supported account types: Accounts in this organizational directory only (Single Tenant)
- [Required] Redirect Uri: Web Platform. The redirect URI for your company is accesible within the 'Manage' page under 'Callback'.
-
Generate a secret for the Application Registration. Record this secret so that you can provide it to Assets. This allows Assets to use the Application Registration to authenticate users.
- On the 'Manage' Company page within Assets, enter the Entra Tenant/Directory ID, the Application ID, and the secret within the fields in the 'Microsoft Entra Single-Sign-On (SSO) using Application Registration' dialog.
- Click the 'Submit changes' button.
Users can now use the 'Login' URL to log in to Assets. By default, any user that is passed from the Entra application registration will be created as a user within Assets and count towards the user threshold. In order to prevent users from being able to arbitrarily join Assets, consider applying Microsoft's guidance to restrict Entra Application Registrations to individual users or security groups within Entra ID.