Here are answers to some of the most popular questions about sapio365
Why is sapio365 a desktop application?
Is my Office 365 data cached on my computer while using sapio365?
While sapio365 retrieves your tenant data to display it in a grid, ONLY the user and group lists are stored locally on your machine. This caching is necessary for much faster loading when dealing with massive numbers of users and groups.
Cached data is stored in a local database encrypted by and for the current computer. Note that caching is an option that can be disabled at any time.
No tenant data is stored once your session is closed except for the cache (if enabled), files you've downloaded and any grid data you've exported.
I see what looks like files in the sapio365 interface. Is what I see a copy of my OneDrive files?
Can sapio365 be automated?
Office 365 changes quite rapidly. How often are new sapio365 versions released?
What are the minimum system requirements for running sapio365?
- Free space: 200 MB on your destination drive
- RAM: As much as possible*
- CPU: As fast as possible*
Does Ytria have any access to my Office 365 data?
Ytria doesn't even have access to the sapio365 trace log, unless you choose to send a copy to us for support purposes.
Why is sapio365 making me sign-in and grant permissions? Is this secure?
When first launching sapio365 with either a Standard or Advanced session, you are asked to sign-in with your Microsoft Office 365 credentials. If the authentication is successful and if you are allowed to consent to applications, you will then be prompted by Microsoft to grant ‘app consent’ to sapio365. This Microsoft dialog says: “This app would like to: ”, followed by a list of permissions.
The consent you give is strictly between the sapio365 app and your tenant. And since sapio365 is installed on your computer, this means that your data NEVER goes through any third-party servers. Learn more about consent here.
How do I create an Advanced session with privileges?
Step 1 In an active Advanced session, click on the ‘Elevate Privileges’ button at the top left.
Step 2 Click on 'Continue' to create the application in your Azure AD (this may take a few minutes).
Step 3 Click on 'Proceed' to continue. You'll only see this dialog box after your first launch of an Advanced session in sapio365.
Step 5 Consent to the permissions used by the application.
You're now ready to access all mailbox and site content!
Step 1 Go to https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade and sign in with your credentials.
Step 3 Name your application.
Redirect URI (optional): If you choose not to give consent during the registration process (Step 7) and to give consent directly in sapio365, you will need to enter the following URI: http://localhost:33366. This is the default address used by sapio365 to complete the consent process. If you need to enter a different address, you may.
Step 4 Register it.
Step 7 Click on “User.Read” permission.
Step 8 Remove this permission.
Step 9 Click on “Add permission”.
Step 13 Select permissions.
In each category, check the required permissions (see the recommended list below) and when finished, click on Add permissions.
You have full flexibility to add whichever permissions you choose. The following list of permission scopes is simply a suggestion. To learn more about these permission scopes, see the Active Directory v.2 Permission Scope Reference Guide.
For a complete experience, the following permission scopes should be assigned:
If you have opted to consent through the application, skip the next steps and go to step 17.
Step 14 Click “Grant admin consent for ….”
Step 15 Confirm the consent request.
Step 17 Go to “Certificates & secrets”.
Step 18 Click on “New client secret”.
Step 19 Choose an expiration period.
Step 20 Click “Add”.
What is Cosmos DB
Azure Cosmos DB is a globally distributed, database service, transparently replicating your data across any number of Azure regions.
Why we use Cosmos DB?
sapio365 uses Cosmos DB to securely store RBAC information and settings. This means all data remains secure within your Tenant ecosystem - Ytria has no access.
How many times can I install sapio365?
With a sapio365 subscription license, you can install sapio365 as many times as needed. The only limitations for this type of license are the number of tenants, and the total number of Office 365 users, all tenants combined.
What types of information do I have to provide to use a sapio365 subscription license?
If you have purchased a subscription license, you will have to link to your license the tenants* you wish to access with sapio365.
If you sign in with an account on a tenant that is not linked to your license, you will be prompted to configure your license to include this tenant.*
Please note: you can only make changes to this configuration once a month.
*This only applies to tenants with over 50 users. sapio365 is free to use on tenants with up to 50 Office 365 users. You will not be asked to configure your license for these tenants.
How many tenants can I link up to a sapio365 license?
sapio365 subscription licenses can be linked to up to 10 Office 365 tenants at once. If you need to work with more than 10 tenants, please contact Ytria sales.
Are there any other restrictions on linking tenants to my license other than the user and tenant count?
You can change the tenants that a sapio365 license is linked to once a month. Once a change has been made to your tenant list, you'll need to wait a full month before making another change.
How can I increase the Office 365 user cap on my license? What about decreasing the allowed user count?
You can change the total number of Office 365 users authorized for your sapio365 license directly within sapio365 itself.
In the sapio365 backstage tab, go to 'About sapio365 > License Modification.' From there you will be able to change the Office 365 user capacity of your license.
Step 1: Enter your requested user capacity. You can choose to either reduce or increase the capacity.
Step 2: Choose when you would like the change to take effect.
A capacity reduction will only take place at the start of the next billing cycle. No refunds will be given.
For a capacity increase, if you choose to have the change take effect at the start of the next billing cycle, you will not be charged anything at this time. If you choose immediately, you will be billed the difference once your change is verified.
Step 3: (optional): Click 'Preview Pricing' to see a preview of what you will be charged if you apply your changes.
Step 4: Enter your Cleverbridge Subscription Reference ID#. No changes will be made unless you provide this number. You can find this number in your original subscription confirmation email and invoice.
Step 5: Apply your changes.
Further action is required! Once you apply your changes, a confirmation email containing a validation link will be sent to the email associated with the license. Your changes will NOT be applied unless validated through this link.
What are action tokens?
Action tokens provide you with a cost-effective alternative to sapio365's standard license system. Tokens are essentially prepaid sapio365 actions that you can use whenever and however you want.
Tokens allow consultants the freedom to work across their entire tenant load without limits. There is no need to prioritize clients based on their Office 365 user base, as a standard license is based on this. With a token-based license there are no limits on tenant amount.
With this pay-as-you-go system, you don't have to commit to anything. And you can budget your sapio365 usage and access in a much more granular way. All this without limits on the number of tenants you can work with.
What is an "action" when it comes to using my sapio365 tokens?
It's actually quite easy to remember if you think about it this way. In sapio365 there are information retrieval/push actions, such as loading users or groups; loading messages, group memberships, OneDrive files; and reloading grid information or modifying users or groups. And there are data manipulation actions, which include things like filtering, sorting, and categorization of data within an already-open grid.
Tokens are only used for information retrieval actions.
More specifically, each initial data load of 500 entries (e.g. loading the list of users or groups) from the "home" screen will use one token.
And every time a different "type" of data is retrieved (such as user messages, group memberships, OneDrive files, etc.) in a "sub-module" view, one token is used.
Here's a quick rundown of a process of seeing your users' group memberships and making changes in sapio365, with the number of tokens it would take to complete it:
Let's say your tenant contains 2000 Office 365 users.
Following the simple process above will use a total of 6 tokens.