Repository: syncope Updated Branches: refs/heads/master e04439481 -> 715e1d399
http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-policy.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-policy.adoc b/src/main/asciidoc/cli/cli-policy.adoc new file mode 100644 index 0000000..af51145 --- /dev/null +++ b/src/main/asciidoc/cli/cli-policy.adoc @@ -0,0 +1,166 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== Policy command +The policy command serves to retrieve the information about the policies for each type. + +===== Help message +[source,bash] +---- +Usage: policy [options] + Options: + --help + --details + --list + Syntax: --list-policy {POLICY-TYPE} + Policy type: ACCOUNT / PASSWORD / SYNC / PUSH + --read + Syntax: --read {POLICY-ID} {POLICY-ID} [...] + --delete + Syntax: --delete {POLICY-ID} {POLICY-ID} [...] +---- + +===== Details option +This option shows a table with policies amount for each type. + +[source] +-- +$ ./syncopeadm.sh policy --details +-- + +[source] +-- + +You are runnig: policy --details + +################################# +# # +# POLICIES DETAILS # +# # +################################# +# # # +# DETAIL # VALUE # +# # # +################################# +# # # +# total number # 9 # +# account policies # 2 # +# password policies # 3 # +# sync policies # 4 # +# push policies # 0 # +# # # +################################# + +-- + +===== List option +Running the command with this option you will see the list of the policies. + +[source] +-- +$ ./syncopeadm.sh Usage: policy --list {POLICY-TYPE} + Policy type: ACCOUNT / PASSWORD / SYNC / PUSH +-- + +[source] +-- + +You are runnig: policy --list SYNC + + > KEY: 1 + type: SYNC + description: a sync policy + resources : [] + realms : [] + + > KEY: 3 + type: SYNC + description: sync policy 2 + resources : [resource-csv] + realms : [] + conflict resolution action: ALL + correlation rule : {USER=["username","firstname"]} + + > KEY: 7 + type: SYNC + description: sync policy 1 + resources : [] + realms : [] + conflict resolution action: IGNORE + correlation rule : {} + + > KEY: 9 + type: SYNC + description: sync policy for java rule + resources : [ws-target-resource-2] + realms : [] + conflict resolution action: IGNORE + correlation rule : {} + +-- + +===== Read option +The option to read all the information of specified policy. + +[source] +-- +$ ./syncopeadm.sh policy --read {POLICY-ID} {POLICY-ID} [...] +-- + +Unlike the list option, the read one shows only the policy passed as input. +[source] +-- +You are runnig: policy --read 6 + + > KEY: 6 + type: ACCOUNT + description: sample account policy + resources : [] + realms : [/odd] + max authentication attempts : 3 + propagation suspension : false + RULES : + > class : [org.apache.syncope.common.lib.policy.DefaultAccountRuleConf@708a538f[ + maxLength=0 + minLength=4 + pattern=<null> + allUpperCase=false + allLowerCase=false + wordsNotPermitted=[] + schemasNotPermitted=[] + prefixesNotPermitted=[notpermitted1, notpermitted2] + suffixesNotPermitted=[] + name=org.apache.syncope.common.lib.policy.DefaultAccountRuleConf +]] +-- + +===== Delete option +The option to delete a specified policy. + +[source] +-- +$ ./syncopeadm.sh policy --delete {POLICY-ID} {POLICY-ID} [...] +-- + +The delete option, as can be imagined, tries to remove a specified policy. +The output will be something like: +[source] +-- + - Policy {POLICY-ID} successfully deleted +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-question.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-question.adoc b/src/main/asciidoc/cli/cli-question.adoc new file mode 100644 index 0000000..c9ef57b --- /dev/null +++ b/src/main/asciidoc/cli/cli-question.adoc @@ -0,0 +1,77 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== Question command +The question command serves to retrieve the information about the user question to retrieve his password. + +===== Help message +[source,bash] +---- +Usage: question [options] + Options: + --help + --list + --read + Syntax: --read {QUESTION-ID} {QUESTION-ID} [...] + --delete + Syntax: --delete {QUESTION-ID} {QUESTION-ID} [...] +---- + +===== List option +Running the command with this option you will see the list of questions with their content. + +[source] +-- +$ ./syncopeadm.sh question --list +-- + +[source] +-- + +You are runnig: question --list + + > SECURITY QUESTION ID: 1 + content: What's your mother's maiden name? + +-- + +===== Read option +The option to read all the information of specified questions. + +[source] +-- +$ ./syncopeadm.sh question --read {QUESTION-ID} {QUESTION-ID} [...] +-- + +Unlike the list option, the read one shows only the questions passed as input. + +===== Delete option +The option to delete a specified questions. + +[source] +-- +$ ./syncopeadm.sh question --delete {QUESTION-ID} {QUESTION-ID} [...] +-- + +The delete option, as can be imagined, tries to remove a specified questions. +The output will be something like: +[source] +-- + - security question {QUESTION-ID} successfully deleted +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-realm.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-realm.adoc b/src/main/asciidoc/cli/cli-realm.adoc new file mode 100644 index 0000000..2b6855b --- /dev/null +++ b/src/main/asciidoc/cli/cli-realm.adoc @@ -0,0 +1,111 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== Realm command +The realm command serves to retrieve the information about the configured realm. + +===== Help message +[source,bash] +---- +Usage: realm [options] + Options: + --help + --details + --list +---- + +===== Details option +This option shows a table with realm amount. + +[source] +-- +$ ./syncopeadm.sh realm --details +-- + +[source] +-- + +You are runnig: realm --details + +############################ +# # +# REALMS DETAILS # +# # +############################ +# # # +# DETAIL # VALUE # +# # # +############################ +# # # +# Total number # 4 # +# # # +############################ + +-- + +===== List option +Running the command with this option you will see the list of the realms. + +[source] +-- +$ ./syncopeadm.sh realm --list +-- + +[source] +-- + +You are runnig: realm --list + + > REALM ID: 1 + name: / + full path: / + actions: [] + templates: {} + parent id: 0 + account policy id: null + password policy id: 4 + + > REALM ID: 2 + name: odd + full path: /odd + actions: [] + templates: {} + parent id: 1 + account policy id: 6 + password policy id: 4 + + > REALM ID: 3 + name: even + full path: /even + actions: [] + templates: {} + parent id: 1 + account policy id: null + password policy id: 4 + + > REALM ID: 4 + name: two + full path: /even/two + actions: [] + templates: {} + parent id: 3 + account policy id: 5 + password policy id: 2 + +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-report.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-report.adoc b/src/main/asciidoc/cli/cli-report.adoc new file mode 100644 index 0000000..48ee95a --- /dev/null +++ b/src/main/asciidoc/cli/cli-report.adoc @@ -0,0 +1,251 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== Report command +The report command serves to retrieve the information about the configured reports. + +===== Help message +[source,bash] +---- +Usage: report [options] + Options: + --help + --details + --list + --list-jobs + --read + Syntax: --read {REPORT-ID} {REPORT-ID} [...] + --delete + Syntax: --delete {REPORT-ID} {REPORT-ID} [...] + --execute + Syntax: --execute {REPORT-ID} + --read-execution + Syntax: --read-execution {EXECUTION-ID} {EXECUTION-ID} [...] + --delete-execution + Syntax: --delete-execution {EXECUTION-ID} {EXECUTION-ID} [...] + --export-execution-result + Syntax: --export-execution-result {EXECUTION-ID} {EXECUTION-ID} [...] {FORMAT} + Format: CSV / HTML / PDF / XML / RTF +---- + +===== Details option +This option shows a table with some details about the reports and their executions. + +[source] +-- +$ ./syncopeadm.sh report --details +-- + +[source] +-- + +You are runnig: report --details + +############################## +# # +# REPORTS DETAILS # +# # +############################## +# # # +# DETAIL # VALUE # +# # # +############################## +# # # +# Total numbers # 1 # +# Never executed # 0 # +# # # +############################## + +-- + +===== List all option +Running the command with this option you will see the list of report configured. + +[source] +-- +$ ./syncopeadm.sh report --list +-- +[source] +-- +You are runnig: report --list + + > REPORT ID: 1 + name: test + cron expression: null + latest execution status: SUCCESS + start date: Sun Feb 26 15:40:04 CET 2012 + end date: Sun Feb 26 15:41:04 CET 2012 + CONF: + name: testUserReportlet + features: [key, username, workflowId, status, creationDate, lastLoginDate, changePwdDate, passwordHistorySize, failedLoginCount, memberships, resources] + plain attributes: [fullname, gender] + derived attributes: [cn] + virtual attributes: [virtualdata] + matching condition: null + EXECUTION: + REPORT EXEC ID: 1 + status: SUCCESS + message: null + start date: Sun Feb 26 15:40:04 CET 2012 + end date: Sun Feb 26 15:41:04 CET 2012 + report id: 1 +-- + +===== List reports execution option +Running the command with this option you will see the list of the report execution executed. + +[source] +-- +$ ./syncopeadm.sh report --list-jobs +-- + +[source] +-- + +You are runnig: report --list-jobs + + REPORT EXEC ID: 0 + status: Not Scheduled + message: null + start date: null + end date: null + report id: 1 + +-- + +===== Read option +The option to read all the information of specified report. + +[source] +-- +$ ./syncopeadm.sh report --read {REPORT-ID} {REPORT-ID} [...] +-- + +[source] +-- +You are runnig: report --read 1 + + > REPORT ID: 1 + name: test + cron expression: null + latest execution status: SUCCESS + start date: Sun Feb 26 15:40:04 CET 2012 + end date: Sun Feb 26 15:41:04 CET 2012 + CONF: + name: testUserReportlet + features: [key, username, workflowId, status, creationDate, lastLoginDate, changePwdDate, passwordHistorySize, failedLoginCount, memberships, resources] + plain attributes: [fullname, gender] + derived attributes: [cn] + virtual attributes: [virtualdata] + matching condition: null + EXECUTION: + REPORT EXEC ID: 1 + status: SUCCESS + message: null + start date: Sun Feb 26 15:40:04 CET 2012 + end date: Sun Feb 26 15:41:04 CET 2012 + report id: 1 +-- + +===== Read report executions option +The option to read all the information of specified report execution. + +[source] +-- +$ ./syncopeadm.sh rreport --read-execution {EXECUTION-ID} {EXECUTION-ID} [...] +-- + +[source] +-- +You are runnig: report --read-execution 1 + + REPORT EXEC ID: 1 + status: SUCCESS + message: null + start date: Sun Feb 26 15:40:04 CET 2012 + end date: Sun Feb 26 15:41:04 CET 2012 + report id: 1 +-- + +===== Delete option +The option to delete a specified report. + +[source] +-- +$ ./syncopeadm.sh report --delete {REPORT-ID} {REPORT-ID} [...] +-- + +The delete option, as can be imagined, tries to remove a specified report. +[source] +-- + - Report {REPORT-ID} successfully deleted +-- + +===== Delete report executions option +The option to delete a specified report execution. + +[source] +-- +$ ./syncopeadm.sh report --delete-execution {EXECUTION-ID} {EXECUTION-ID} [...] +-- + +The delete option, as can be imagined, tries to remove a specified report execution. +[source] +-- + - Report execution {EXECUTION-ID} successfully deleted + +===== Execute option +The option to run a report. + +[source] +-- +$ ./syncopeadm.sh report --execute {REPORT-ID} +-- + +[source] +-- +You are runnig: report --execute 1 + + - Report 1executed. + + + - Run --read 1 to see the results. +-- + +As you can read, after the execution, if the result is positive, you have to read the report to know the execution +results. + +===== Export execution option +The option to export an execution in a certain format to see the results. + +[NOTE] +At the moment only the XML format is supported. + +[source] +-- +$ ./syncopeadm.sh eport --export-execution-result {EXECUTION-ID} {EXECUTION-ID} [...] {FORMAT} + Format: CSV / HTML / PDF / XML / RTF +-- + +[source] +-- +You are runnig: report --export-execution-result 101 XML + + - export_101.xml created. +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-resource.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-resource.adoc b/src/main/asciidoc/cli/cli-resource.adoc new file mode 100644 index 0000000..10d31b4 --- /dev/null +++ b/src/main/asciidoc/cli/cli-resource.adoc @@ -0,0 +1,208 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== Resource command +The resource command serves to retrieve the information about the resources. + +===== Help message +[source,bash] +---- +Usage: resource [options] + Options: + --help + --details + --list + --read + Syntax: --read {RESOURCE-NAME} {RESOURCE-NAME} [...] + --delete + Syntax: --delete {RESOURCE-NAME} {RESOURCE-NAME} [...] +---- + +===== Details option +This option shows a table with resource amount. + +[source] +-- +$ ./syncopeadm.sh resource --details +-- + +[source] +-- + +You are runnig: resource --details + +############################# +# # +# RESOURCES DETAILS # +# # +############################# +# # # +# DETAIL # VALUE # +# # # +############################# +# # # +# Total numbers # 19 # +# # # +############################# + +-- + +Total number:: + number of resources; + +===== List option +Running the command with this option you will see the list of the resources. + +[source] +-- +$ ./syncopeadm.sh resource --list +-- + +[source] +-- + +You are runnig: resource --list + + > RESOURCE ID: ws-target-resource-1 + connector dispaly name: ConnInstance100 + etag value: 1287565200000 + connector id: 100 + account policy id: null + password policy id: null + sync policy id: null + creator: admin + creation date: Wed Oct 20 11:00:00 CEST 2010 + last modifier: admin + last change date: Wed Oct 20 11:00:00 CEST 2010 + propagation actions class: [] + propagation priority: 1 + PROVISIONS: + provision id: 15 + any type: USER + object class: __ACCOUNT__ + sync token: null + virtual schema: [] + MAPPING: + ConnObjectLink: null + MAPPING ITEM: + mapping key: 99 + mapping item type: UserKey + internal attribute name: id + external attribute name: userId + mandatory condition: true + transformers class: [] + purpose: PROPAGATION + connector object key: true + password: false + + mapping key: 100 + mapping item type: UserPlainSchema + internal attribute name: email + external attribute name: email + mandatory condition: true + transformers class: [] + purpose: PROPAGATION + connector object key: false + password: false + + mapping key: 101 + mapping item type: UserPlainSchema + internal attribute name: surname + external attribute name: surname + mandatory condition: true + transformers class: [] + purpose: PROPAGATION + connector object key: false + password: false + + mapping key: 102 + mapping item type: Password + internal attribute name: password + external attribute name: __PASSWORD__ + mandatory condition: true + transformers class: [] + purpose: PROPAGATION + connector object key: false + password: true + + mapping key: 335 + mapping item type: UserPlainSchema + internal attribute name: surname + external attribute name: fullname + mandatory condition: true + transformers class: [] + purpose: PROPAGATION + connector object key: false + password: false + + mapping key: 336 + mapping item type: UserPlainSchema + internal attribute name: type + external attribute name: type + mandatory condition: true + transformers class: [] + purpose: PROPAGATION + connector object key: false + password: false + + mapping key: 337 + mapping item type: UserPlainSchema + internal attribute name: firstname + external attribute name: name + mandatory condition: false + transformers class: [] + purpose: NONE + connector object key: false + password: false + + create trace level: ALL + delete trace level: ALL + update trace level: ALL + sync trace level: ALL + enforce mandatory condition: false + override capabilities: false + random password if not provided: false + [...] + +-- + +===== Read option +The option to read all the information of specified resource. + +[source] +-- +$ ./syncopeadm.sh resource --read {RESOURCE-NAME} {RESOURCE-NAME} [...] +-- + +Unlike the list option, the read one shows only the resources passed as input. + +===== Delete option +The option to delete a specified resource. + +[source] +-- +$ ./syncopeadm.sh resource --delete {RESOURCE-NAME} {RESOURCE-NAME} [...] +-- + +The delete option, as can be imagined, tries to remove a specified resources. +The output will be something like: +[source] +-- + - Resource {RESOURCE-NAME} successfully deleted +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-role.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-role.adoc b/src/main/asciidoc/cli/cli-role.adoc new file mode 100644 index 0000000..cc3f244 --- /dev/null +++ b/src/main/asciidoc/cli/cli-role.adoc @@ -0,0 +1,149 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== Role command +The role command serves to retrieve the information about the roles. + +===== Help message +[source,bash] +---- +Usage: role [options] + Options: + --help + --details + --list + --read + Syntax: --read {ROLE-NAME} {ROLE-NAME} [...] + --delete + Syntax: --delete {ROLE-NAME} {ROLE-NAME} [...] +---- + +===== Details option +This option shows a table with some details about the roles. + +[source] +-- +$ ./syncopeadm.sh role --details +-- + +[source] +-- + +You are runnig: role --details + +#################################### +# # +# ROLES DETAILS # +# # +#################################### +# # # +# DETAIL # VALUE # +# # # +#################################### +# # # +# Total number # 4 # +# Without entitlements # 0 # +# # # +#################################### + +-- + +Total number:: + number of created roles; +Without entitlements:: + number of roles without linked entitlments. + +===== List option +Running the command with this option you will see the list of roles with the realm where are configured +and their entitlments. + +[source] +-- +$ ./syncopeadm.sh role --list +-- + +[source] +-- + +You are runnig: role --list + + > ROLE ID: User reviewer + REALMS: + - /odd + - /even + ENTITLEMENTS: + - USER_READ + - USER_LIST + - USER_SEARCH + dynamic membership condition: null + + > ROLE ID: User manager + REALMS: + - / + ENTITLEMENTS: + - WORKFLOW_FORM_SUBMIT + - USER_READ + - USER_LIST + - USER_SEARCH + - WORKFLOW_FORM_CLAIM + dynamic membership condition: null + + > ROLE ID: Other + REALMS: + - /odd + ENTITLEMENTS: + - SCHEMA_READ + - GROUP_READ + - WORKFLOW_FORM_CLAIM + dynamic membership condition: null + + > ROLE ID: Search for realm evenTwo + REALMS: + - /even/two + ENTITLEMENTS: + - USER_READ + - USER_SEARCH + dynamic membership condition: null + +-- + +===== Read option +The option to read all the information of specified roles. + +[source] +-- +$ ./syncopeadm.sh role --read {ROLE-NAME} {ROLE-NAME} [...] +-- + +Unlike the list option, the read one shows only the roles passed as input. + +===== Delete option +The option to delete a specified roles. + +[source] +-- +$ ./syncopeadm.sh role --delete {ROLE-NAME} {ROLE-NAME} [...] +-- + +The delete option, as can be imagined, tries to remove a specified roles. +The output will be something like: +[source] +-- + - role {ROLE-NAME} successfully deleted +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-schema.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-schema.adoc b/src/main/asciidoc/cli/cli-schema.adoc new file mode 100644 index 0000000..0e88f07 --- /dev/null +++ b/src/main/asciidoc/cli/cli-schema.adoc @@ -0,0 +1,303 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== Schema command +The schema command serves to retrieve the information about every schema categories. + +===== Help message +[source,bash] +---- +Usage: schema [options] + Options: + --help + --details + --list-all + --list-plain + --list-derived + --list-virtual + --read {SCHEMA-TYPE} {SCHEMA-KEY} + Schema type: PLAIN / DERIVED / VIRTUAL + --delete {SCHEMA-TYPE} {SCHEMA-KEY} + Schema type: PLAIN / DERIVED / VIRTUAL +---- + +===== Details option +This option shows a table with some details about the schemas and their categories. + +[source] +-- +$ ./syncopeadm.sh schema --details +-- + +[source] +-- + +You are runnig: schema --details + +############################## +# # +# SCHEMAS DETAILS # +# # +############################## +# # # +# DETAIL # VALUE # +# # # +############################## +# # # +# total number # 57 # +# plain schema # 44 # +# derived schema # 10 # +# virtual schema # 3 # +# # # +############################## + +-- + +===== List all option +Running the command with this option you will see the list of all (PLAIN, DERIVED, VIRTUAL) schemas configured. + +[source] +-- +$ ./syncopeadm.sh schema --list-all +-- + +===== List plain option +Running the command with this option you will see the list of the plain schemas available in Syncope. + +[source] +-- +$ ./syncopeadm.sh schema --list-plain +-- + +[source] +-- + +You are runnig: schema --list-plain + +################################################################ +# # +# PLAIN SCHEMAS # +# # +################################################################ +# # # # +# SCHEMA KEY # TYPE # MANDATORY # +# # # # +################################################################ +# # # # +# password.cipher.algorithm # String # true # +# notificationjob.cronExpression # String # false # +# notification.maxRetries # Long # true # +# token.length # Long # true # +# token.expireTime # Long # true # +# selfRegistration.allowed # Boolean # true # +# passwordReset.allowed # Boolean # true # +# passwordReset.securityQuestion # Boolean # true # +# authentication.statuses # String # true # +# log.lastlogindate # Boolean # true # +# tasks.interruptMaxRetries # Long # true # +# return.password.value # Boolean # false # +# admin.user.layout # String # false # +# self.user.layout # String # false # +# admin.group.layout # String # false # +# self.group.layout # String # false # +# admin.membership.layout # String # false # +# self.membership.layout # String # false # +# fullname # String # true # +# userId # String # true # +# loginDate # Date # false # +# firstname # String # false # +# surname # String # true # +# type # String # false # +# email # String # false # +# activationDate # Date # false # +# uselessReadonly # String # false # +# cool # Boolean # false # +# gender # Enum # false # +# aLong # Long # false # +# makeItDouble # Long # false # +# obscure # Encrypted # false # +# photo # Binary # false # +# icon # String # false # +# show # Boolean # false # +# rderived_sx # String # false # +# rderived_dx # String # false # +# title # String # false # +# subscriptionDate # Date # false # +# mderived_sx # String # false # +# mderived_dx # String # false # +# postalAddress # String # false # +# model # String # false # +# location # String # false # +# # # # +################################################################ + +-- + +===== List derived option +Running the command with this option you will see the list of the derived schemas available in Syncope with +their expression. + +[source] +-- +$ ./syncopeadm.sh schema --list-derived +-- + +[source] +-- + +You are runnig: schema --list-derived + +####################################################################################### +# # +# DERIVED SCHEMAS # +# # +####################################################################################### +# # # +# SCHEMA KEY # EXPRESSION # +# # # +####################################################################################### +# # # +# csvuserid # firstname + ',' + surname # +# cn # surname + ', ' + firstname # +# noschema # surname + ', ' + notfound # +# info # username + ' - ' + creationDate + '[' + failedLogins + ']' # +# rderiveddata # rderived_sx + '-' + rderived_dx # +# displayProperty # icon + ': ' + show # +# rderToBePropagated # rderived_sx + '-' + rderived_dx # +# rderivedschema # rderived_sx + '-' + rderived_dx # +# mderiveddata # mderived_sx + '-' + mderived_dx # +# mderToBePropagated # mderived_sx + '-' + mderived_dx # +# # # +####################################################################################### + +-- + +===== List virtual option +Running the command with this option you will see the list of the virtual schemas available in Syncope. + +[source] +-- +$ ./syncopeadm.sh schema --list-virtual +-- + +[source] +-- + +You are runnig: schema --list-virtual + +################################## +# # +# VIRTUAL SCHEMAS # +# # +################################## +# # # +# SCHEMA KEY # READONLY # +# # # +################################## +# # # +# virtualReadOnly # true # +# rvirtualdata # false # +# virtualdata # false # +# # # +################################## + +-- + +===== Read option +The option to read all the information of specified schema. + +[source] +-- +$ ./syncopeadm.sh schema --read {SCHEMA-TYPE} {SCHEMA-KEY} + Schema type: PLAIN / DERIVED / VIRTUAL +-- + +Unlike the list option, the read one shows the schema passed as input and, in case of PLAIN category, the full +attributes of it. + +[source] +-- + +You are runnig: schema --read PLAIN email + + > SCHEMA ID: email + type: String + any type class: minimal user + conversion pattern: null + mandatory condition: false + mime type: null + validator class: org.apache.syncope.core.persistence.jpa.attrvalue.validation.EmailAddressValidator + chiper algorithm: + +-- +[source] +-- + +You are runnig: schema --read DERIVED info + +############################################################################### +# # +# DERIVED SCHEMAS # +# # +############################################################################### +# # # +# SCHEMA KEY # EXPRESSION # +# # # +############################################################################### +# # # +# info # username + ' - ' + creationDate + '[' + failedLogins + ']' # +# # # +############################################################################### + +-- +[source] +-- + +You are runnig: schema --read VIRTUAL virtualReadOnly + +################################## +# # +# VIRTUAL SCHEMAS # +# # +################################## +# # # +# SCHEMA KEY # READONLY # +# # # +################################## +# # # +# virtualReadOnly # true # +# # # +################################## + +-- + +===== Delete option +The option to delete a specified schema. + +[source] +-- +$ ./syncopeadm.sh schema --delete {SCHEMA-TYPE} {SCHEMA-KEY} + Schema type: PLAIN / DERIVED / VIRTUAL +-- + +The delete option, as can be imagined, tries to remove a specified schema. +[source] +-- + - Schema {SCHEMA-KEY} successfully deleted +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-task.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-task.adoc b/src/main/asciidoc/cli/cli-task.adoc new file mode 100644 index 0000000..b57a535 --- /dev/null +++ b/src/main/asciidoc/cli/cli-task.adoc @@ -0,0 +1,315 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== Task command +The connector command serves to retrieve the information around the connector configuration in Apache Syncope. + +===== Help message +[source,bash] +---- +Usage: task [options] + Options: + --help + --details + --list + Syntax: --list {TASK-TYPE} + Task type: NOTIFICATION / PROPAGATION / PUSH / SCHEDULED / SYNCHRONIZATION + --list-running-jobs + --list-scheduled-jobs + --read + Syntax: --read {TASK-ID} {TASK-ID} [...] + --read-execution + Syntax: --read-execution {TASK-EXEC-ID} {TASK-EXEC-ID} [...] + --delete + Syntax: --delete {TASK-ID} {TASK-ID} [...] + --delete-execution + Syntax: --delete-execution {TASK-EXEC-ID} {TASK-EXEC-ID} [...] + --execute + Syntax: --execute {TASK-ID} {DRY-RUN} + Dry run: true / false +---- + +===== Details option +This option shows a table with some details about tasks and jobs. + +[source] +-- +$ ./syncopeadm.sh task --details +-- + +[source] +-- + +You are runnig: task --details + +############################################################## +# # +# TASKS DETAILS # +# # +############################################################## +# # # +# DETAIL # VALUE # +# # # +############################################################## +# # # +# total number # 28 # +# notification tasks # 1 # +# notification tasks not executed # 1 # +# propagation tasks # 5 # +# propagation tasks not executed # 3 # +# push tasks # 11 # +# push tasks not executed # 11 # +# scheduled tasks # 1 # +# scheduled tasks not executed # 1 # +# synchronization tasks # 10 # +# synchronization tasks not executed # 10 # +# synchronization tasks with full reconciliation # 5 # +# running jobs # 0 # +# scheduled jobs # 1 # +# # # +############################################################## + +-- + +===== List option +Running the command with this option you will see the list of selected tasks type with their information. + +[source] +-- +$ ./syncopeadm.sh - task --list {TASK-TYPE} + Task type: NOTIFICATION / PROPAGATION / PUSH / SCHEDULED / SYNCHRONIZATION +-- + +[source] +-- + +You are runnig: task --list SCHEDULED + + - Scheduled task key: 5 + name: SampleJob Task + cron expression: 0 0 0 1 * ? + description: null + start date: null + end date: null + last execution: null + next execution: Tue Dec 01 00:00:00 CET 2015 + latest execution status: + job delegate class: org.apache.syncope.fit.core.reference.TestSampleJobDelegate + +-- + +The last snippet code shows the information of the scheduled tasks. + +===== List running jobs +Running the command with this option you will see the list of the actual running jobs. + +[source] +-- +$ ./syncopeadm.sh task --list-running-jobs +-- + +[source] +-- + - There is NOT running jobs available +-- + +===== List scheduled jobs +Running the command with this option you will see the list of the actual scheduled jobs. + +[source] +-- +$ ./syncopeadm.sh task --list-scheduled-jobs +-- + +[source] +-- + EXECUTIONS: + - task execution key: 0 + task: 5 + message: + ############### <BEGIN MESSAGE> ############### + message: null + ############### <END MESSAGE> ############### + status: NORMAL + start date: Fri Nov 27 15:11:23 CET 2015 + end date: null +-- + +===== Read option +The option to read all the information of specified tasks. + +[source] +-- +$ ./syncopeadm.sh task --read {TASK-ID} {TASK-ID} [...] +-- + +Unlike the list option, the read one shows only the tasks passed as input. Below the commad to read the task with +id 13 +[source] +-- +You are runnig: task --read 13 + + - Push task key: 13 + name: Export on resource-testdb2 + resource: resource-testdb2 + cron expression: null + description: null + is perform create: true + is perform delete: true + is perform update: true + is sync status: true + start date: null + end date: null + last execution: null + next execution: null + latest execution status: + filters: {GROUP=name==_NO_ONE_, USER=surname==Vivaldi} + delegate class: null + action class: [] + matching rule: IGNORE + not matching rule: ASSIGN +-- + +===== Read execution option +The option to read all the information of executions task. + +[source] +-- +$ ./syncopeadm.sh task --read-execution {TASK-EXEC-ID} {TASK-EXEC-ID} [...] +-- + +===== Delete option +The option to delete a specified tasks. + +[source] +-- +$ ./syncopeadm.sh task --delete {TASK-ID} TASK-ID} [...] +-- + +The delete option, as can be imagined, tries to remove a specified tasks. +[source] +-- + - task {TASK-ID} successfully deleted +-- + +===== Delete execution option +The option to delete a specified execution tasks. +[source] +-- +$ ./syncopeadm.sh task --delete {TASK-EXEC-ID} {TASK-EXEC-ID} [...] +-- + +The delete option, as can be imagined, tries to remove a specified execution tasks. +[source] +-- + - task {TASK-EXEC-ID} successfully deleted +-- + +===== Execute option +The option to execute a specified execution tasks. +[source] +-- +$ ./syncopeadm.sh task --execute {TASK-ID} {DRY-RUN} + Dry run: true / false +-- + +For instance, executing the PUSH task with id 13 in dry run mode the result is +[source] +-- + You are runnig: task --execute 13 false + EXECUTIONS: + - task execution key: 0 + task: 13 + message: + ############### <BEGIN MESSAGE> ############### + message: Job fired; waiting for results... + ############### <END MESSAGE> ############### + status: JOB_FIRED + start date: Fri Nov 27 16:02:24 CET 2015 + end date: null +-- +then reading again the task id you will find the execution results among the other task information +[source] +-- +- Push task key: 13 + name: Export on resource-testdb2 + resource: resource-testdb2 + cron expression: null + description: null + is perform create: true + is perform delete: true + is perform update: true + is sync status: true + start date: Fri Nov 27 16:02:24 CET 2015 + end date: Fri Nov 27 16:02:26 CET 2015 + last execution: null + next execution: null + latest execution status: SUCCESS + filters: {GROUP=name==_NO_ONE_, USER=surname==Vivaldi} + delegate class: null + action class: [] + matching rule: IGNORE + not matching rule: ASSIGN + EXECUTIONS: + - task execution key: 15 + task: 13 + message: + ############### <BEGIN MESSAGE> ############### + message: Users [created/failures]: 1/0 [updated/failures]: 0/0 [deleted/failures]: 0/0 [no operation/ignored]: 0/0 +Groups [created/failures]: 0/0 [updated/failures]: 0/0 [deleted/failures]: 0/0 [no operation/ignored]: 0/0 +Any objects [created/failures]: 0/0 [updated/failures]: 0/0 [deleted/failures]: 0/0 [no operation/ignored]: 0/0 + +Users created: +CREATE SUCCESS (id/name): 3/vivaldi + +Users updated: + +Users deleted: + +Users no operation: + +Users ignored: + + +Groups created: + +Groups updated: + +Groups deleted: + +Groups no operation: + +Groups ignored: + + +Any objects created: + +Any objects updated: + +Any objects deleted: + +Any objects no operation: + +Any objects ignored: + + ############### <END MESSAGE> ############### + status: SUCCESS + start date: Fri Nov 27 16:02:24 CET 2015 + end date: Fri Nov 27 16:02:26 CET 2015 +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli-user.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli-user.adoc b/src/main/asciidoc/cli/cli-user.adoc new file mode 100644 index 0000000..155de69 --- /dev/null +++ b/src/main/asciidoc/cli/cli-user.adoc @@ -0,0 +1,535 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// + +==== User command +The user command serves to retrieve the information about the users. + +===== Help message +[source,bash] +---- +Usage: user [options] + Options: + --help + --list + --details + --get-user-key + Syntax: --get-user-key {USERNAME} {USERNAME} [...] + --get-username + Syntax: --get-username {USER-ID} {USER-ID} [...] + --read + Syntax: --read {USER-ID} {USER-ID} [...] + --search-by-attribute + Syntax: --search-by-attribute {REALM} {ATTR-NAME}={ATTR-VALUE} + --search-by-role + Syntax: --search-by-role {REALM} {ROLE-ID} + --search-by-resource + Syntax: --search-by-resource {REALM} {RESOURCE-NAME} + --delete + Syntax: --delete {USER-ID} {USER-ID} [...] + --delete-all + Syntax: --delete-all {REALM} + --delete-by-attribute + Syntax: --delete-by-attribute {REALM} {ATTR-NAME}={ATTR-VALUE} +---- + +===== Details option +This option shows a table with some details about the users. + +[source] +-- +$ ./syncopeadm.sh user --details +-- + +[source] +-- + +You are runnig: user --details + +################################# +# # +# USERS DETAILS # +# # +################################# +# # # +# DETAIL # VALUE # +# # # +################################# +# # # +# Total number # 5 # +# Active # 5 # +# Suspended # 0 # +# Without resources # 0 # +# Without roles # 2 # +# # # +################################# + +-- + +===== List option +Running the command with this option you will see the list of all user in the environment but, before the execution, +the system will ask you a confirmation because as you can imagine this operation might produce very heavy output. + +[source] +-- +$ ./syncopeadm.sh user --list +-- +[source] +-- +You are runnig: user --list + +This operation might produce very heavy output. Do you want to continue? [yes/no] +yes + + > USER ID: 2 + username: verdi + realm: / + status: active + RESOURCES: + - ws-target-resource-list-mappings-1 + - ws-target-resource-list-mappings-2 + ROLES: + creation date: Wed Oct 20 11:00:00 CEST 2010 + change password date: null + PLAIN ATTRIBUTES: + fullname: [Giuseppe Verdi] + firstname: [Giuseppe] + surname: [Verdi] + userId: [[email protected]] + email: [[email protected]] + DERIVED ATTRIBUTES: + info: [verdi - 2010-10-20T11:00:00+0200[0]] - is readonly. + noschema: [Verdi, ] - is readonly. + cn: [Verdi, Giuseppe] - is readonly. + VIRTUAL ATTRIBUTES: + creator: admin + last modifier: admin + token: null + token expiration time: null + last change: Wed Oct 20 11:00:00 CEST 2010 + last login: null + failed logins: 0 +RELATIONSHIPS: + security question id: null + security question answer id: null + +-- + +===== Get user key option +The option to get the user key starting from an username. + +[source] +-- +$ ./syncopeadm.sh user --get-user-key {USERNAME} +-- + +[source] +-- +You are runnig: user --get-user-key rossini + + - rossini user ID is 1 +-- + +===== Get username option +The option to get the username starting from an user id. + +[source] +-- +$ ./syncopeadm.sh user --get-user-key {USER-ID} +-- + +[source] +-- +You are runnig: user --get-username 1 + + - 1 username is rossini +-- + +===== Read by user id option +The option to read user information by his user id. + +[source] +-- +$ ./syncopeadm.sh user --read {USER-ID} {USER-ID} [...] +-- + +[source] +-- + +You are runnig: user --read 1 + + > USER ID: 1 + username: rossini + realm: /even + status: active + RESOURCES: + - resource-testdb2 + - ws-target-resource-2 + ROLES: + - Other + creation date: Wed Oct 20 11:00:00 CEST 2010 + change password date: null + PLAIN ATTRIBUTES: + type: [G] + fullname: [Gioacchino Rossini] + firstname: [Gioacchino] + surname: [Rossini] + userId: [[email protected]] + loginDate: [2009-05-26, 2010-05-26] + DERIVED ATTRIBUTES: + info: [rossini - 2010-10-20[0]] - is readonly. + noschema: [Rossini, ] - is readonly. + cn: [Rossini, Gioacchino] - is readonly. + VIRTUAL ATTRIBUTES: + creator: admin + last modifier: admin + token: null + token expiration time: null + last change: Wed Oct 20 11:00:00 CEST 2010 + last login: null + failed logins: 0 +RELATIONSHIPS: + security question id: null + security question answer id: null + +-- + +===== Read by username option +The option to read user information by his username. + +[source] +-- +$ ./syncopeadm.sh user --read {USERNAME} {USERNAME} [...] +-- + +[source] +-- + +You are runnig: user --read rossini + + > USER ID: 1 + username: rossini + realm: /even + status: active + RESOURCES: + - resource-testdb2 + - ws-target-resource-2 + ROLES: + - Other + creation date: Wed Oct 20 11:00:00 CEST 2010 + change password date: null + PLAIN ATTRIBUTES: + type: [G] + fullname: [Gioacchino Rossini] + firstname: [Gioacchino] + surname: [Rossini] + userId: [[email protected]] + loginDate: [2009-05-26, 2010-05-26] + DERIVED ATTRIBUTES: + info: [rossini - 2010-10-20[0]] - is readonly. + noschema: [Rossini, ] - is readonly. + cn: [Rossini, Gioacchino] - is readonly. + VIRTUAL ATTRIBUTES: + creator: admin + last modifier: admin + token: null + token expiration time: null + last change: Wed Oct 20 11:00:00 CEST 2010 + last login: null + failed logins: 0 +RELATIONSHIPS: + security question id: null + security question answer id: null + +-- + +===== Search by attribute option +The option to searcn a list of users with a common attribute. + +[source] +-- +$ ./syncopeadm.sh user --search-by-attribute {REALM} {ATTR-NAME}={ATTR-VALUE} +-- + +For instance if you want to search the active users under the root realm: + +[source] +-- + +You are runnig: user --search-by-attribute / status=active + + > USER ID: 2 + username: verdi + realm: / + status: active + RESOURCES: + - ws-target-resource-list-mappings-1 + - ws-target-resource-list-mappings-2 + ROLES: + creation date: Wed Oct 20 11:00:00 CEST 2010 + change password date: null + PLAIN ATTRIBUTES: + fullname: [Giuseppe Verdi] + firstname: [Giuseppe] + surname: [Verdi] + userId: [[email protected]] + email: [[email protected]] + DERIVED ATTRIBUTES: + info: [verdi - 2010-10-20T11:00:00+0200[0]] - is readonly. + noschema: [Verdi, ] - is readonly. + cn: [Verdi, Giuseppe] - is readonly. + VIRTUAL ATTRIBUTES: + creator: admin + last modifier: admin + token: null + token expiration time: null + last change: Wed Oct 20 11:00:00 CEST 2010 + last login: null + failed logins: 0 +RELATIONSHIPS: + security question id: null + security question answer id: null + + > USER ID: 3 + username: vivaldi + realm: / + status: active + RESOURCES: + - ws-target-resource-delete + - ws-target-resource-1 + - ws-target-resource-2 +[...] +-- + +===== Search by role option +The option to searcn a list of users with a specified role. + +[source] +-- +$ ./syncopeadm.sh user --search-by-role {REALM} {ROLE-NAME} +-- + +[source] +-- + +You are runnig: user --search-by-role / Other + + > USER ID: 1 + username: rossini + realm: /even + status: active + RESOURCES: + - resource-testdb2 + - ws-target-resource-2 + ROLES: + - Other + creation date: Wed Oct 20 11:00:00 CEST 2010 + change password date: null + PLAIN ATTRIBUTES: + type: [G] + fullname: [Gioacchino Rossini] + firstname: [Gioacchino] + surname: [Rossini] + userId: [[email protected]] + loginDate: [2009-05-26, 2010-05-26] + DERIVED ATTRIBUTES: + info: [rossini - 2010-10-20[0]] - is readonly. + noschema: [Rossini, ] - is readonly. + cn: [Rossini, Gioacchino] - is readonly. + VIRTUAL ATTRIBUTES: + creator: admin + last modifier: admin + token: null + token expiration time: null + last change: Wed Oct 20 11:00:00 CEST 2010 + last login: null + failed logins: 0 +RELATIONSHIPS: + security question id: null + security question answer id: null + +-- + +===== Search by resource option +The option to searcn a list of users with a specified resource. + +[source] +-- +$ ./syncopeadm.sh user --search-by-resource {REALM} {RESOURCE-NAME} +-- + +[source] +-- + +You are runnig: user --search-by-resource / ws-target-resource-2 + + > USER ID: 3 + username: vivaldi + realm: / + status: active + RESOURCES: + - ws-target-resource-delete + - ws-target-resource-1 + - ws-target-resource-2 + ROLES: + creation date: Wed Oct 20 11:00:00 CEST 2010 + change password date: null + PLAIN ATTRIBUTES: + firstname: [Antonio] + surname: [Vivaldi] + fullname: [Antonio Vivaldi] + userId: [[email protected]] + email: [[email protected]] + type: [F] + DERIVED ATTRIBUTES: + cn: [Vivaldi, Antonio] - is readonly. + noschema: [Vivaldi, ] - is readonly. + info: [vivaldi - 2010-10-20T11:00:00+0200[0]] - is readonly. + VIRTUAL ATTRIBUTES: + creator: admin + last modifier: admin + token: null + token expiration time: null + last change: Wed Oct 20 11:00:00 CEST 2010 + last login: null + failed logins: 0 +RELATIONSHIPS: + security question id: null + security question answer id: null + + > USER ID: 1 + username: rossini + realm: /even + status: active + RESOURCES: + - resource-testdb2 + - ws-target-resource-2 + ROLES: + - Other + creation date: Wed Oct 20 11:00:00 CEST 2010 + change password date: null + PLAIN ATTRIBUTES: + type: [G] + fullname: [Gioacchino Rossini] + firstname: [Gioacchino] + surname: [Rossini] + userId: [[email protected]] + loginDate: [2009-05-26, 2010-05-26] + DERIVED ATTRIBUTES: + info: [rossini - 2010-10-20[0]] - is readonly. + noschema: [Rossini, ] - is readonly. + cn: [Rossini, Gioacchino] - is readonly. + VIRTUAL ATTRIBUTES: + creator: admin + last modifier: admin + token: null + token expiration time: null + last change: Wed Oct 20 11:00:00 CEST 2010 + last login: null + failed logins: 0 +RELATIONSHIPS: + security question id: null + security question answer id: null + +-- + +===== Delete option +The option to delete a specified user. + +[source] +-- +$ ./syncopeadm.sh user --delete {{USER-ID} {USER-ID} [...] +-- + +The delete option, as can be imagined, tries to remove a specified user. +[source] +-- + - User {USER-ID} successfully deleted +-- + +===== Delete by attribute option +The option to delete the users with a common attribute. + +[source] +-- +$ ./syncopeadm.sh user --delete-by-attribute {REALM} {ATTR-NAME}={ATTR-VALUE} +-- + +[source] +-- + You are runnig: user --delete-by-attribute / surname=Rossini + + - Deleted users: 1 +-- + +===== Delete all option +The option to delete all users of the realm passe as input. + +[source] +-- +$ ./syncopeadm.sh user --delete-all {REALM} +-- + +The delete option, as can be imagined, tries to remove every users under the passed realm. + +[NOTE] +To run this operation the system asks you again the admin credential. + +[source] +-- +You are runnig: user --delete-all / + +Running this operation you will delete all the realm users managed by Syncope, are you sure? [yes/no] +yes + +Username: +admin + +Password: +password +Deleting process started + + - Deleted users: 2 + +######################### +# # +# USERS NOT DELETED # +# # +######################### +# # # +# USER ID # CAUSE # +# # # +######################### +# # # +# 5 # FAILURE # +# # # +######################### + +-- + +As you can read the output is composed of two parts. +The first one is the number of deleted users; the second one is a table with the users (user id) don't removed. + +To know the reason why the deletion failed you need to run the command with the standard delete option. + +[source] +-- +You are runnig: user --delete 5 + + - Error: GroupOwnership [6 director] +-- \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/cli/cli.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/cli/cli.adoc b/src/main/asciidoc/cli/cli.adoc new file mode 100644 index 0000000..4d6784d --- /dev/null +++ b/src/main/asciidoc/cli/cli.adoc @@ -0,0 +1,57 @@ +// +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. +// +=== CLI + +include::cli-introduction.adoc[] + +include::cli-installation.adoc[] + +include::cli-connector.adoc[] + +include::cli-question.adoc[] + +include::cli-role.adoc[] + +include::cli-configuration.adoc[] + +include::cli-logger.adoc[] + +include::cli-task.adoc[] + +include::cli-notification.adoc[] + +include::cli-schema.adoc[] + +include::cli-user.adoc[] + +include::cli-report.adoc[] + +include::cli-resource.adoc[] + +include::cli-policy.adoc[] + +include::cli-info.adoc[] + +include::cli-entitlement.adoc[] + +include::cli-domain.adoc[] + +include::cli-realm.adoc[] + +include::cli-group.adoc[] \ No newline at end of file http://git-wip-us.apache.org/repos/asf/syncope/blob/715e1d39/src/main/asciidoc/reference-guide.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/reference-guide.adoc b/src/main/asciidoc/reference-guide.adoc index a19d3a9..683c46c 100644 --- a/src/main/asciidoc/reference-guide.adoc +++ b/src/main/asciidoc/reference-guide.adoc @@ -120,7 +120,7 @@ provisioning, and compliance. === Using the Admin Console -include::cli.adoc[] +include::cli/cli.adoc[] === RESTful services
