Overview

SMART Migration needs permissions to access and work with Team Folders in Nextcloud. To handle this securely and efficiently, we use a group-based approach that gives administrators full control over the migration process.

The SMARTMigration Group

When a job starts, SMART Migration automatically creates a special Nextcloud group called “SMARTMigration.” This group acts as a bridge between the migration account and the Team Folders. Think of it as a master key that can be granted or revoked as needed.

How Permissions Work

For simplicity and consistency, the SMARTMigration group always receives full “Read, Write, Delete” permissions (permission level 15) when added to a Team Folder. This unified approach ensures Predictable behavior: so the tool always has the permissions it needs for any operation

Benefits for Administrators

This approach provides several advantages:

  • Full audit trail: All migration activities are logged under the SMARTMigration group, making it easy to track what was accessed and when
  • Simple access control: Administrators can instantly revoke all migration access by simply deleting the SMARTMigration group
  • Easy reactivation: If migration needs to resume or continue later, the group is then automatically recreated and permissions reassigned to the relevant Team Folders

Security and Flexibility

This design ensures that the migration account only has access when needed and only to the folders being actively migrated. While the group has full permissions when active, removing the group immediately cuts off all access, maintaining security while providing the flexibility to resume operations whenever necessary.

Last modified: 19 December 2025