Write ocs end-points for occ commands and other admin settings

[schiessle]

Edit: Not completed items are moved to Nextcloud 13: #4904

I would be good to have a OCS API for all our occ and admin settings so that a Nextcloud installation can be administrated from outside.

Here is a list of what we need:

• app:
  • check-code - makes no sense
  • disable: provisioning_api
  • enable: provisioning_api
  • list: provisioning_api
• background:
  • ajax: config=>system:set
  • cron: config=>system:set
  • webcron: config=>system:set
• config
  • app:delete: provisioning_api
  • app:get: provisioning_api
  • app:set: provisioning_api
  • import
  • list: provisioning_api for apps
  • system:delete
  • system:get
  • system:set
• db:
  • convert-type - makes no sense
  • generate-change-script - makes no sense
• encryption:
  • change-key-storage-root
  • decrypt-all - Timeout critical
  • disable
  • enable
  • enable-master-key
  • encrypt-all - Timeout critical
  • list-modules
  • migrate
  • set-default-module
  • show-key-storage-root
  • status
• files
  • files:cleanup
  • files:scan - Timeout critical
  • files:transfer-ownership - Timeout critical
• integrity:
  • integrity:check-app
  • integrity:check-core
  • integrity:sign-app - makes no sense
  • integrity:sign-core - makes no sense
• ldap:
  • ldap:check-user
  • ldap:create-empty-config → Part 1 of LDAP Backend OCS Api #3162
  • ldap:delete-config → Part 1 of LDAP Backend OCS Api #3162
  • ldap:search
  • ldap:set-config → Part 1 of LDAP Backend OCS Api #3162
  • ldap:show-config → Part 1 of LDAP Backend OCS Api #3162
  • ldap:show-remnants
  • ldap:test-config
• maintenance:
  • maintenance:mimetype:update-db
  • maintenance:mimetype:update-js
  • maintenance:mode: config=>system:set
  • maintenance:repair
  • maintenance:singleuser: config=>system:set
  • maintenance:update:htaccess
• user
  • user:lastseen
  • user:report
  • user:resetpassword
• versions
  • versions:cleanup
• sharing
  • set default expire date and other sharing settings: provisioning_api

Beginning with Nextcloud 11 we can probably set most of them already with ocs/v2.php/apps/provisioning_api/api/v1/config/apps/{app}/{key} by sending GET, POST and DELETE requests

Please double check for your apps @nickvergessen @blizzz @rullzer @icewind1991 @LukasReschke

[nickvergessen]

I added some information and killed some that just make no sense.

[jancborchardt]

To relay what we talked about via private mail: It would be cool to rename the command from the very technical (and outdated) occ to nextcloud.

(Or if that causes name conflicts, nextcloud-cmd or so. Ideally a less technical word than cmd though …)

[blizzz]

With regard to the LDAP part, do I understand correctly that the OCS spec needs to be extended? Since the only fitting service is CONFIG, but only a GET method is specified.

[nickvergessen]

Beginning with Nextcloud 11 we can probably set most of them already with ocs/v2.php/apps/provisioning_api/api/v1/config/apps/{app}/{key} by sending GET, POST and DELETE requests

Post is also fine, so should be okay I think?

[blizzz]

Only GET is specified (1.7 draft, but same in 1.6)

[nickvergessen]

That's a different endpoint...

[blizzz]

Ok, meanhwhile I figured out the doc at opendesktop.org is abandoned, in favor https://lukasreschke.github.io/OpenCloudMeshSpecification, while this is not complete either. Which isn't acutally good, but eases things… Our own doc is a bit dusty on this, too → nextcloud/documentation#312

[MorrisJobke]

I created a new ticket for 13 for the not yet implemented end points: #4904