2021-06-26 11:23:15 -04:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace BookStack\Auth\Access;
|
2019-08-07 06:07:21 -04:00
|
|
|
|
|
|
|
use BookStack\Auth\Role;
|
|
|
|
use BookStack\Auth\User;
|
2020-08-04 09:55:01 -04:00
|
|
|
use Illuminate\Support\Collection;
|
2019-08-07 06:07:21 -04:00
|
|
|
|
2021-10-06 18:05:26 -04:00
|
|
|
class GroupSyncService
|
2019-08-07 06:07:21 -04:00
|
|
|
{
|
|
|
|
/**
|
|
|
|
* Check a role against an array of group names to see if it matches.
|
|
|
|
* Checked against role 'external_auth_id' if set otherwise the name of the role.
|
|
|
|
*/
|
2019-11-16 10:24:09 -05:00
|
|
|
protected function roleMatchesGroupNames(Role $role, array $groupNames): bool
|
2019-08-07 06:07:21 -04:00
|
|
|
{
|
|
|
|
if ($role->external_auth_id) {
|
2019-11-16 10:24:09 -05:00
|
|
|
return $this->externalIdMatchesGroupNames($role->external_auth_id, $groupNames);
|
2019-08-07 06:07:21 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
$roleName = str_replace(' ', '-', trim(strtolower($role->display_name)));
|
2021-06-26 11:23:15 -04:00
|
|
|
|
2019-08-07 06:07:21 -04:00
|
|
|
return in_array($roleName, $groupNames);
|
|
|
|
}
|
|
|
|
|
2019-11-16 10:24:09 -05:00
|
|
|
/**
|
|
|
|
* Check if the given external auth ID string matches one of the given group names.
|
|
|
|
*/
|
|
|
|
protected function externalIdMatchesGroupNames(string $externalId, array $groupNames): bool
|
|
|
|
{
|
2022-05-04 16:03:13 -04:00
|
|
|
foreach ($this->parseRoleExternalAuthId($externalId) as $externalAuthId) {
|
|
|
|
if (in_array($externalAuthId, $groupNames)) {
|
2019-11-16 10:24:09 -05:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2022-05-04 16:03:13 -04:00
|
|
|
protected function parseRoleExternalAuthId(string $externalId): array
|
|
|
|
{
|
|
|
|
$inputIds = preg_split('/(?<!\\\),/', $externalId);
|
|
|
|
$cleanIds = [];
|
|
|
|
|
|
|
|
foreach ($inputIds as $inputId) {
|
|
|
|
$cleanIds[] = str_replace('\,', ',', trim($inputId));
|
|
|
|
}
|
|
|
|
|
|
|
|
return $cleanIds;
|
|
|
|
}
|
|
|
|
|
2019-08-07 06:07:21 -04:00
|
|
|
/**
|
|
|
|
* Match an array of group names to BookStack system roles.
|
|
|
|
* Formats group names to be lower-case and hyphenated.
|
|
|
|
*/
|
2020-08-04 09:55:01 -04:00
|
|
|
protected function matchGroupsToSystemsRoles(array $groupNames): Collection
|
2019-08-07 06:07:21 -04:00
|
|
|
{
|
|
|
|
foreach ($groupNames as $i => $groupName) {
|
|
|
|
$groupNames[$i] = str_replace(' ', '-', trim(strtolower($groupName)));
|
|
|
|
}
|
|
|
|
|
2020-08-04 09:55:01 -04:00
|
|
|
$roles = Role::query()->get(['id', 'external_auth_id', 'display_name']);
|
2019-08-07 06:07:21 -04:00
|
|
|
$matchedRoles = $roles->filter(function (Role $role) use ($groupNames) {
|
|
|
|
return $this->roleMatchesGroupNames($role, $groupNames);
|
|
|
|
});
|
|
|
|
|
|
|
|
return $matchedRoles->pluck('id');
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2021-06-26 11:23:15 -04:00
|
|
|
* Sync the groups to the user roles for the current user.
|
2019-08-07 06:07:21 -04:00
|
|
|
*/
|
2021-10-06 18:05:26 -04:00
|
|
|
public function syncUserWithFoundGroups(User $user, array $userGroups, bool $detachExisting): void
|
2019-08-07 06:07:21 -04:00
|
|
|
{
|
|
|
|
// Get the ids for the roles from the names
|
2019-08-07 09:31:10 -04:00
|
|
|
$groupsAsRoles = $this->matchGroupsToSystemsRoles($userGroups);
|
2019-08-07 06:07:21 -04:00
|
|
|
|
|
|
|
// Sync groups
|
2021-10-06 18:05:26 -04:00
|
|
|
if ($detachExisting) {
|
2019-08-07 09:31:10 -04:00
|
|
|
$user->roles()->sync($groupsAsRoles);
|
2020-02-02 12:31:00 -05:00
|
|
|
$user->attachDefaultRole();
|
2019-08-07 06:07:21 -04:00
|
|
|
} else {
|
2019-08-07 09:31:10 -04:00
|
|
|
$user->roles()->syncWithoutDetaching($groupsAsRoles);
|
2019-08-07 06:07:21 -04:00
|
|
|
}
|
|
|
|
}
|
2021-10-16 11:01:59 -04:00
|
|
|
}
|