{"id":15051332,"url":"https://github.com/nextcloud/shareimporter","last_synced_at":"2025-06-12T09:38:16.541Z","repository":{"id":38021347,"uuid":"444959032","full_name":"nextcloud/shareimporter","owner":"nextcloud","description":"Import SMB shares from a web service upon login","archived":false,"fork":false,"pushed_at":"2025-01-16T11:23:55.000Z","size":128,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-30T08:43:10.580Z","etag":null,"topics":["nextcloud","smb"],"latest_commit_sha":null,"homepage":"https://apps.nextcloud.com/apps/shareimporter","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nextcloud.png","metadata":{"files":{"readme":"README.de.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-05T21:46:20.000Z","updated_at":"2025-01-16T11:23:58.000Z","dependencies_parsed_at":"2023-12-13T13:44:39.103Z","dependency_job_id":"6ece11e6-e3fb-4691-b3bb-421b3f5736bc","html_url":"https://github.com/nextcloud/shareimporter","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fshareimporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fshareimporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fshareimporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fshareimporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nextcloud","download_url":"https://codeload.github.com/nextcloud/shareimporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237228680,"owners_count":19275737,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nextcloud","smb"],"created_at":"2024-09-24T21:33:32.077Z","updated_at":"2025-02-05T02:32:50.425Z","avatar_url":"https://github.com/nextcloud.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n  - SPDX-FileCopyrightText: 2023 Nextcloud GmbH and Nextcloud contributors\n  - SPDX-License-Identifier: AGPL-3.0-or-later\n--\u003e\n# Share-Importer\n\nDer Share-Importer ist eine Nextcloud-App, die automatisiert SMB-Shares eines Benutzers einbindet. Die Shares, die einem Benutzer zugeordnet sind, werden durch einen externen Webservice geliefert, der nicht Bestandteil der App ist.\n\n## Arbeitsweise\n\nDie Share-Importer-App nutzt einen *Event-Listener* für das *UserLoggedIn*\\-Event, um bei jeder Anmeldung eines Benutzers aufgerufen zu werden. Dabei wird eine HTTP-Request an den Webservice gestellt, um zu dem Benutzernamen eine Liste von SMB-Shares zu erhalten. Mit dieser Liste wird dann ein oder mehrere SMB-Mounts innerhalb von Nextcloud ausgeführt. Damit sind die dem Benutzer zugeordneten Shares nach dem Login automatisch verfügbar.\n\n## Installation\n\nDas Verzeichnis *shareimporter* muss im Nextcloud-Basisverzeichnis unter *apps* abgelegt werden. Einige Konfigurationsvariablen müssen zwingend gesetzt werden (siehe unten).\n\n## Konfiguration\n\nDie Konfiguration wird in der Nextcloud-Konfigurationsdatei *config.php* vorgenommen.\n\n| Konfigurationsvariable | Beschreibung | Typ | Default |\n|------------------------|--------------|-----|---------|\n| share_importer_exclude_users | Liste von Benutzern, für die vom Share-Importer ignoriert werden | Array | \u003cleer\u003e |\n| share_importer_webservice_url | vollständige URL für den Zugriff auf den Webservice, muss gesetzt sein | String | \u003cleer\u003e |\n| share_importer_webservice_api_key | API-Key für den Zugriff auf den Webservice, muss gesetzt sein | String | \u003cleer\u003e |\n| share_importer_webservice_verify_certificate | *true*, wenn das Server-Zertifikat des Webservice überprüft werden soll, sonst *false* | Boolean | *true* |\n| share_importer_webservice_timeout | Timeout in Sekunden für die Antwort vom Webservice | Integer | 5 |\n| share_importer_webservice_connect_timeout | Timeout in Sekunden für den Verbindungsaufbau zum Webservice | Integer | 5 |\n| share_importer_auth_mech | Name des Nextcloud-internen Authentifizierungsmechanismus für das SMB-Share. Mit dem Default-Wert \"*password:sessioncredentials*\" wird das Nextcloud-Anmeldepasswort\" durchgereicht. | String | *password:sessioncredentials* |\n\n## Webservice\n\nDer Shareimporter führt eine HTTP-GET-Request auf die konfigurierte URL aus.  Als URL-encoded-Parameter wird der Benutzername in der Form `?username=\u003cusername\u003e` mitgegeben. Der API-Key wird in dem HTTP-Header \"*ApiKey*\" übertragen.\n\n**Beispiel JSON-Antwort:**\n\n```\n{ \"username\": \"testuser\", \"shares\" : [ { \"mountpoint\": \"T:test\", \"share\": \"test\", \"host\": \"localhost\",\"domain\":\"WORKGROUP\",\"type\":\"smb\" } ]}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Fshareimporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextcloud%2Fshareimporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Fshareimporter/lists"}