CompanyBrain NLEN Sign in

Where CompanyBrain writes to

Everything CompanyBrain fetches goes straight to storage you choose. Below you find, per storage, how it connects, which permissions we ask for, what the folders look like and which files appear.

Folder structure

By default we write per AI platform, per employee and per day. The path is adjustable with the fields {source}, {user}, {yyyy}, {mm}, {dd} and {project}.

{source}/{user}/{yyyy}/{mm}/{yyyy}-{mm}-{dd}.jsonl
{source}/{user}/journal-{yyyy}-{mm}.md
{source}/{user}/bijlagen/{yyyy}/{mm}/{record-id}/{bestandsnaam}

File formats

  • JSONL per platform, employee and day. Every line is a record with id, time, source, user, kind, project, summary and the full original response of the platform.
  • Markdown per employee per month: a readable journal with a line per event.
  • Attachments as the original file, only for Claude Enterprise, up to the configured size (25 MB by default). On storage that cannot write binary files only the details of the attachment are in the logs.

Every run is idempotent: records are merged on their id, so there are never duplicate lines, even if a day runs again.

Azure Blob Storage

Object storage in your own Azure environment

How it connects

  • With a SAS URL (recommended)
  • With a service principal

Which permissions we ask for

With a SAS URL: Read, Add, Create, Write and List on that one container (Delete is optional). With a service principal: the role Storage Blob Data Contributor, on that container only.

Steps for the administrator

  1. Create a storage account in Azure with a container in it.
  2. Open the container and choose Shared access tokens.
  3. Give the permissions Read, Add, Create, Write and List and choose a long expiry date.
  4. Copy the full SAS URL and paste it below.

Amazon S3

Object storage in your own AWS environment

How it connects

  • With an IAM role (recommended)
  • With an access key

Which permissions we ask for

An IAM role or access key with only PutObject, GetObject, DeleteObject and ListBucket on the bucket and folder. For an IAM role we show the trust and permissions policy to copy.

Steps for the administrator

  1. Create a bucket in AWS.
  2. Create an IAM role with the permissions policy below.
  3. Copy the trust policy below into the role.
  4. Enter the bucket, the region and the ARN of the role below.

S3-compatible

Hetzner, Cloudflare R2, MinIO and other S3 storage

How it connects

  • With an access key

Which permissions we ask for

A key pair with access to that bucket only.

Steps for the administrator

  1. Create a bucket and a key pair with access to that bucket only at your provider.
  2. Look up the address of the storage, for Hetzner that is https://location.your-objectstorage.com.
  3. Enter the address, the bucket and both keys below.

OneDrive

A folder of its own in your OneDrive

How it connects

  • Sign in with Microsoft

Which permissions we ask for

Sign in with Microsoft with only the permission Files.ReadWrite.AppFolder. CompanyBrain only sees its own folder Apps/CompanyBrain.

Steps for the administrator

  1. Click Connect and sign in with your Microsoft account.
  2. Give consent. CompanyBrain gets a folder of its own, Apps/CompanyBrain.

SharePoint

A document library on your SharePoint site

How it connects

  • Sign in with Microsoft

Which permissions we ask for

Sign in with Microsoft with the permission Sites.ReadWrite.All (on behalf of the signed-in person). Only addresses on sharepoint.com are allowed. Preferably use a separate account that may only write in that library.

Steps for the administrator

  1. Enter the address of your SharePoint site and the library.
  2. Click Connect and sign in with an account that may write in that library.
  3. Turn on versioning or a retention policy in the library so the logs cannot be changed.

Google Drive

A folder of its own in your Google Drive

How it connects

  • Sign in with Google

Which permissions we ask for

Sign in with Google with only the permission drive.file. CompanyBrain only sees the folder it creates itself.

Steps for the administrator

  1. Click Connect and sign in with your Google account.
  2. Give consent. CompanyBrain only sees the folder it creates itself.

Dropbox

A folder of its own in your Dropbox

How it connects

  • Sign in with Dropbox

Which permissions we ask for

Sign in with Dropbox with the permissions files.content.write and files.content.read. CompanyBrain gets a folder of its own, Apps/CompanyBrain.

Steps for the administrator

  1. Click Connect and sign in to Dropbox.
  2. Give consent. CompanyBrain gets a folder of its own, Apps/CompanyBrain.

GitHub

A private repository on GitHub

How it connects

  • With an access token

Which permissions we ask for

A fine-grained token with only the Contents permission on that one private repository.

Steps for the administrator

  1. Create a private repository on GitHub.
  2. Create a fine-grained access token that may only read and write this repository (Contents).
  3. Enter the token and the name of the repository below.

Azure DevOps

A Git repository in Azure DevOps

How it connects

  • With an access token

Which permissions we ask for

An access token with the Code permission (read and write).

Steps for the administrator

  1. Create a Git repository in your Azure DevOps project.
  2. Create an access token with the permission Code (read and write).
  3. Enter the token and the details of the repository below.

Tip: turn on immutable storage (WORM) or a retention policy on the storage. Then nobody can change the logs afterwards.

Which AI platforms we can connect · Security