Spaceman Cloud with Local Access Control — OneDrive Setup Guide
This guide is for sites where Spaceman is hosted in the cloud and your access control system (such as PTI) runs on a local server. Follow these steps to connect the two using Microsoft OneDrive.
Do I need this?
You'd need it if your Spaceman software runs in the cloud, but your access control system — the hardware and software that controls entry to your units — runs on a computer at your site. The two systems need to share a file so that your access control system knows who is allowed in.
We use Microsoft OneDrive to bridge the gap. Here is how it works:
- On a regular schedule, your Spaceman Cloud system generates an access control file.
- It uploads that file to a folder in your OneDrive.
- The OneDrive app on your local server automatically syncs/downloads it to your PC.
- Your access control system reads the file as it normally would — nothing changes on that side.
Once set up, this all happens automatically in the background. No manual steps are needed day to day, and no user logins are required.
Before you begin
You will need:
- A Microsoft 365 account with OneDrive (WORK or SCHOOL account)
NOTE: Please ensure you create a Work or School account. This will not work with a personal account.
- Access to your organisation's Azure Active Directory — you will need an administrator account, or the help of your IT department, for one of the steps below
- Access to the PC or server where your access control system runs
Step 1 — Install OneDrive on your local server
The OneDrive sync app keeps a folder on your PC in sync with your OneDrive storage. You will need this running on the PC or server that runs your access control system.
- On the PC or server, check whether the OneDrive app is already installed — look for a cloud icon in the system tray (bottom-right of the screen). If it is there and signed in, you can skip this step.
- If not installed, OneDrive is included with Windows 10 and 11, or can be downloaded from microsoft.com/onedrive.
- Open the OneDrive app and sign in with your Microsoft 365 account.
- OneDrive will create a synced folder on your PC. It is usually found in File Explorer under OneDrive — [Your Company Name].
Step 2 — Create a folder in OneDrive
Create a dedicated folder where the access control files will be stored.
- Open onedrive.com in a browser and sign in with your Microsoft 365 account.
- Click + New > Folder.
- Give it a clear name, such as Access Control or your site name.
- Note down the folder path (e.g. /Access Control/) — you will need to tell us this later.
Step 3 — Register an application in Azure
This step creates a secure connection that allows our system to upload files to your OneDrive folder automatically, without needing to log in each time. This is done through your organisation's Microsoft Azure portal.
This step requires an administrator account for your organisation's Microsoft 365 / Azure Active Directory. If you are not sure who this is, please ask your IT department.
- Go to portal.azure.com and sign in with an administrator account.
- In the search bar at the top, search for App registrations and open it.
- Click + New registration.
- Fill in the details:
- Name: Something like Spaceman Access Control
- Supported account types: Select Accounts in this organisational directory only
- Redirect URI: Leave blank
- Click Register.
Note down the IDs
On the app's Overview page, copy and keep these two values — you will need to send them to us:
- Application (client) ID
- Directory (tenant) ID
Step 4 — Add API permissions
- In the left-hand menu of your app, click API permissions.
- Click + Add a permission.
- Select Microsoft Graph.
- Select Application permissions (not "Delegated").
- In the search box, type
Files.ReadWrite.Alland tick it. (orSites.ReadWrite.Allfor SharePoint) - Click Add permissions.
- Back on the permissions page, click "Grant admin consent for [your organisation]" and confirm by clicking Yes.
- You should now see a green tick next to
Files.ReadWrite.All.(/Sites.ReadWrite.All)
What does this permission allow? It allows our system to upload and update files in OneDrive. It does not give access to emails, calendars, or any other data. You can revoke this access at any time by deleting the app registration.
Step 5 — Create a client secret
A client secret is like a password that allows our system to connect securely.
- In the left-hand menu of your app, click Certificates & secrets.
- Click + New client secret.
- Give it a description (e.g. Spaceman Access Control) and choose an expiry (24 months is a good choice).
- Click Add.
- Immediately copy the "Value" column — this is your client secret. It is only shown once; if you navigate away, it will be hidden permanently.
Important: Copy the Value, not the Secret ID. The Value is a long string of characters. Keep this safe — treat it like a password.
Step 6 — Send us your details
Please send us the following information via your usual support channel. Please share these details securely where possible. (We have had people use https://onetimesecret.com/en/)
| What | Where to find it |
|---|---|
| Application (client) ID | App overview page in Azure (Step 3) |
| Directory (tenant) ID | App overview page in Azure (Step 3) |
| Client secret Value | Certificates & secrets page in Azure (Step 5) |
| OneDrive account email address | The email address of the person whose OneDrive the folder is in |
| Folder path | The folder name you created in Step 2, e.g. /Access Control/ |
Step 7 — Point your access control system at the synced folder
Once OneDrive is running on your local server, access files will appear inside the OneDrive folder on that PC. You will need to tell your access control system (e.g. PTI) where to look for the file.
The folder is usually found at a path like:
C:\Users\[username]\OneDrive - [Your Company]\Access Control\
The exact path depends on how OneDrive is set up on your PC. You can find it by opening File Explorer and looking inside the OneDrive folder.
If you are unsure how to change the file path in your access control software, please contact your access control system supplier for guidance.
What happens after setup?
You are all set! No additional authorisation step is required — once we have your credentials and have configured the system, it will start working straight away.
Access control files will be generated and uploaded automatically. Your local access control system will pick them up via OneDrive sync.
Remember: If your client secret expires (based on the expiry you set in Step 5), the connection will stop working. We recommend setting a calendar reminder to renew it before it expires. This client secret then needs to go into the Space Manager > Maintenance > Site > Settings > Graph API
Spaceman Cloud — Local Access Control via OneDrive • Last updated March 2026