====== OC Basisdokumentation & Entwicklung ======

Fundamentals [[https://doc.owncloud.org/server/10.0/developer_manual/app/fundamentals/|https://doc.owncloud.org/server/10.0/developer_manual/app/fundamentals/]]

Advanced Concepts [[https://doc.owncloud.org/server/10.0/developer_manual/app/advanced/|https://doc.owncloud.org/server/10.0/developer_manual/app/advanced/]]

Testing Tarballs: [[https://download.owncloud.org/community/testing/|https://download.owncloud.org/community/testing/]]

config.php Parameter: [[https://doc.owncloud.org/server/10.0/admin_manual/configuration/server/config_sample_php_parameters.html|https://doc.owncloud.org/server/10.0/admin_manual/configuration/server/config_sample_php_parameters.html]]

occ Kommandos: https://doc.owncloud.com/server/admin_manual/configuration/server/occ_command.html

===== Installation von Kommandzeile =====

<code>
sudo -u www-data php occ maintenance:install --database "mysql" --database-name "owncloud2"
--database-user "ocadmin" --database-pass "xxxxxxxxxxxxxxx" --admin-user "admin"
--admin-pass "xxxxxxxxxxxx" --data-dir /mnt/data/ocdata2
</code>

===== Update & Maintenance =====

Maintenance Mode aktivieren (global)

<code>
sudo -u www-data php occ maintenance:mode --on
</code>

single user mode, Login nur für User der Admingruppe:

<code>
sudo -u www-data php occ maintenance:singleuser --on
</code>

Upgrade starten

<code>sudo -u www-data php occ upgrade
</code>

Danach Maintenance Mode wieder aus

<code>sudo -u www-data php occ maintenance:mode –-off
</code>

oder

<code>sudo -u www-data php occ maintenance:singleuser -–off
</code>

Configreport nach portal.owncloud.com senden

<code>
sudo -u www-data php occ configreport:generate | curl -XPOST --fail  -H "Content-Type: application/json" -d @- https://portal.owncloud.com/apps/customer_portal/api/account/configreports/KG1c47dYat
</code>


===== Code integrity check =====

<code>
 sudo -u www-data php occ integrity:check-core
 sudo -u www-data php occ integrity:check-app $appid

</code>

Code integrity check global abschalten:

Disable globally with 'integrity.check.disabled' ⇒ true, in config.php

===== Logging =====

Loglevel to start logging at. Valid values are: 0 = Debug, 1 = Info, 2 = Warning, 3 = Error, and 4 = Fatal. The default value is Warning.

===== Code Signing =====

<file>
sudo -u www-data php occ integrity:sign-app
--privateKey=/home/thommie/github/oc-app-signing-netzwissen.de.key
--certificate=/home/thommie/github/oc-app-signing-netzwissen.de.crt
--path=/home/thommie/github/oc-theme-nw/

</file>

===== App Kommandos =====

<code>
app
 app:check-code   check code to be compliant
 app:disable      disable an app
 app:enable       enable an app
 app:getpath      Get an absolute path to the app directory
                  (added in 9.0)
 app:list         List all available apps

</code>

===== User Kommandos =====

Neuen User anlegen (displayname = voller Name, uid = Login)

<code>
sudo -u www-data php occ user:add --display-name 'Herr test1' --email 'support@netzwissen.de' --group 'User' test1

The user "test1" was created successfully
Display name set to "Herr test1"
Email address set to "support@netzwissen.de"
User "test1" added to group "User"
</code>

Passwort als Umgebungsvariable übergeben (z.B. für Masseneintrag) - Achtung, geht nur als root

<code>
''export OC_PASS=newpassword ''''su -s /bin/sh www-data -c
'php occ user:add –password-from-env –display-name="Fred Jones" –group="users" fred' ''

''The user "fred" was created successfully
Display name set to "Fred Jones" User "fred" added to group "users" ''
</code>

==== Passwort Reset ====

**über cli**

<code>
sudo -u www-data php occ user:resetpassword
</code>

**über Mail**

<code>
root@www:/var/www/owncloud# sudo -u www-data php occ user:resetpassword --send-email test1
The password reset link is: https://www.netzwissen.de/owncloud/index.php/lostpassword/reset/form/QgBwq9JIZJbdhXf7NLq7L/test1
</code>

**über Link**

<code>
sudo -u www-data php occ user:resetpassword --output-link test1
</code>

==== User-E-Mail ändern ====

<code>
php occ user:modify someusername email someone@example.com

root@app3:/var/www/owncloud# sudo -u www-data php occ user:modify herre email ngehring@steuerberaterherre.de
The email address of herre updated to ngehring@steuerberaterherre.de
</code>

==== Letzten Login zeigen ====


<code>
sudo -u www-data php occ user:lastseen schreiber-esslingen@t-online.de

</code>

==== Inaktive User suchen  ====

365 Tage
<code>
root@www:/var/www/owncloud# sudo -u www-data php occ user:inactive 365
</code>

==== User löschen ====

<code>
sudo -u www-data php occ user:delete

</code>

==== User temporär abschalten ====


<code>
user:disable [uid]

</code>

==== Einfacher Report über alle User ====


<code>
sudo -u www-data php occ user:report

</code>

==== Rescan aller Daten ====


<code>
sudo -u www-data php console.php files:scan –all

</code>

===== Dateien löschen, scannen, verschieben (bulk) =====

<code>
trashbin:cleanup   Remove deleted files

files
 files:cleanup              cleanup filecache
 files:scan                 rescan filesystem
 files:transfer-ownership   All files and folders are moved to another
                            user - shares are moved as well. (Added in 9.0)

</code>

Datentransfer von User A nach User B:

<file>
sudo -u www-data php occ files:transfer-ownership --path="gruenerheiner" thommie4 gruenerheiner

</file>

Dateien landen beim neuen User in einem separatend transferred-.. Ordner

===== Verschlüsselung =====

user encryption ist deprecated!!!

<code>
sudo -u www-data php occ app:enable encryption

sudo -u www-data php occ encryption:enable

sudo -u www-data php occ encryption:status

</code>

===== Verschlüsselung & Sharing =====

Bei aktiver Verschlüsselung sollte immer über den **Namen** geshared werden, siehe [[https://doc.owncloud.org/server/master/user_manual/files/encrypting_files.html|https://doc.owncloud.org/server/master/user_manual/files/encrypting_files.html]] Erst danach sollte ein Gruppen Share gesetzt werden, der Namens-Share kann dann wieder weg.

====== Datenbankschema ======

{{:wiki:oc_10x_database_structure.pdf|Struktur 10.x}}

====== ownCloud Metrics ======

https://www.netzwissen.de/owncloud/ocs/v1.php/apps/metrics/api/v1/metrics

als jsom

curl -H "OC-MetricsApiKey: eK5oAz9efUmSg@cpS&F4" "https://www.netzwissen.de/owncloud/ocs/v1.php/apps/metrics/api/v1/metrics?users=true&files=true&shares=true&quota=true&userData=true&format=json"

====== OIDC ======

https://doc.owncloud.com/server/admin_manual/configuration/user/oidc/

Client ID erzeugen (php)

<code>
<php
$bytes = random_bytes(32);
var_dump(bin2hex($bytes));
?>
</code>