|DataResponse * * 200: Server added successfully * 404: Server not found at the given URL * 409: Server is already in the list of trusted servers */ #[AuthorizedAdminSetting(settings: Admin::class)] #[ApiRoute(verb: 'POST', url: '/trusted-servers')] public function addServer(string $url): DataResponse { $this->checkServer(trim($url)); // Add the server to the list of trusted servers, all is well $id = $this->trustedServers->addServer(trim($url)); return new DataResponse([ 'url' => $url, 'id' => $id, 'message' => $this->l->t('Added to the list of trusted servers') ]); } /** * Add server to the list of trusted Nextcloud servers * * @param int $id The ID of the trusted server to remove * @return DataResponse|DataResponse * * 200: Server removed successfully * 404: Server not found at the given ID */ #[AuthorizedAdminSetting(settings: Admin::class)] #[ApiRoute(verb: 'DELETE', url: '/trusted-servers/{id}', requirements: ['id' => '\d+'])] public function removeServer(int $id): DataResponse { try { $this->trustedServers->getServer($id); } catch (\Exception $e) { throw new OCSNotFoundException($this->l->t('No server found with ID: %s', [$id])); } try { $this->trustedServers->removeServer($id); return new DataResponse(['id' => $id]); } catch (\Exception $e) { $this->logger->error($e->getMessage(), ['e' => $e]); throw new OCSException($this->l->t('Could not remove server'), Http::STATUS_INTERNAL_SERVER_ERROR); } } /** * List all trusted servers * * @return DataResponse, array{}> * * 200: List of trusted servers */ #[AuthorizedAdminSetting(settings: Admin::class)] #[ApiRoute(verb: 'GET', url: '/trusted-servers')] public function getServers(): DataResponse { $servers = $this->trustedServers->getServers(); // obfuscate the shared secret $servers = array_map(function ($server) { return [ 'url' => $server['url'], 'id' => $server['id'], 'status' => $server['status'], ]; }, $servers); // return the list of trusted servers return new DataResponse($servers); } /** * Check if the server should be added to the list of trusted servers or not. */ #[AuthorizedAdminSetting(settings: Admin::class)] protected function checkServer(string $url): void { if ($this->trustedServers->isTrustedServer($url) === true) { throw new OCSException($this->l->t('Server is already in the list of trusted servers.'), Http::STATUS_CONFLICT); } if ($this->trustedServers->isNextcloudServer($url) === false) { throw new OCSNotFoundException($this->l->t('No server to federate with found')); } } }