1"use strict";(globalThis.webpackChunkgo_c_8_y_cli=globalThis.webpackChunkgo_c_8_y_cli||[]).push([[4558],{83620(e,t,i){i.r(t),i.d(t,{assets:()=>c,contentTitle:()=>a,default:()=>u,frontMatter:()=>o,metadata:()=>n,toc:()=>d});const n=JSON.parse('{"id":"cli/c8y/deviceregistration/c8y_deviceregistration_register-ca","title":"c8y deviceregistration register-ca","description":"Register device with an x509 certificate from the Cumulocity Certificate Authority","source":"@site/docs/cli/c8y/deviceregistration/c8y_deviceregistration_register-ca.md","sourceDirName":"cli/c8y/deviceregistration","slug":"/cli/c8y/deviceregistration/c8y_deviceregistration_register-ca","permalink":"/docs/cli/c8y/deviceregistration/c8y_deviceregistration_register-ca","draft":false,"unlisted":false,"editUrl":"https://github.com/reubenmiller/go-c8y-cli/edit/v2/docs/go-c8y-cli/docs/cli/c8y/deviceregistration/c8y_deviceregistration_register-ca.md","tags":[],"version":"current","frontMatter":{"category":"deviceregistration","title":"c8y deviceregistration register-ca"},"sidebar":"cli","previous":{"title":"c8y deviceregistration register-basic","permalink":"/docs/cli/c8y/deviceregistration/c8y_deviceregistration_register-basic"},"next":{"title":"c8y deviceregistration register-external-ca","permalink":"/docs/cli/c8y/deviceregistration/c8y_deviceregistration_register-external-ca"}}');var r=i(74848),s=i(28453);const o={category:"deviceregistration",title:"c8y deviceregistration register-ca"},a=void 0,c={},d=[{value:"Synopsis",id:"synopsis",level:3},{value:"Examples",id:"examples",level:3},{value:"Options",id:"options",level:3},{value:"Options inherited from parent commands",id:"options-inherited-from-parent-commands",level:3}];function l(e){const t={code:"code",h3:"h3",p:"p",pre:"pre",...(0,s.R)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(t.p,{children:"Register device with an x509 certificate from the Cumulocity Certificate Authority"}),"\n",(0,r.jsx)(t.h3,{id:"synopsis",children:"Synopsis"}),"\n",(0,r.jsx)(t.p,{children:"Register a device using the Cumulocity Certificate Authority to enable the device to request a device certificate\nsecurely using EST. This will be supported by thin-edge.io out-of-the-box."}),"\n",(0,r.jsx)(t.p,{children:'This feature requires the feature toggle, "certificate-authority"'}),"\n",(0,r.jsx)(t.pre,{children:(0,r.jsx)(t.code,{children:"c8y deviceregistration register-ca [flags]\n"})}),"\n",(0,r.jsx)(t.h3,{id:"examples",children:"Examples"}),"\n",(0,r.jsx)(t.pre,{children:(0,r.jsx)(t.code,{children:'$ c8y deviceregistration register-ca --id "ASDF098SD1J10912UD92JDLCNCU8"\nRegister a new device using BASIC authentication and generate a random password (printed on the console)\n\n$ c8y deviceregistration register-ca --id "ASDF098SD1J10912UD92JDLCNCU8" --one-time-password "RqzwJeTusABlk4)KmtIc"\nRegister a new device and provide the one-time-password to be used for enrollment\n\n$ echo -e "device1\\ndevice2" | c8y deviceregistration register-ca --type linux --template "{name: input.value}"\nRegister 2 devices, and set the names based on their external id\n \n'})}),"\n",(0,r.jsx)(t.h3,{id:"options",children:"Options"}),"\n",(0,r.jsx)(t.pre,{children:(0,r.jsx)(t.code,{children:' -d, --data stringArray static data to be applied to body. accepts json or shorthand json, i.e. --data \'value1=1,my.nested.value=100\'\n --external-type string The type of the external ID. If IDTYPE doesn\'t appear in the file, the default value is used. The default value is c8y_Serial (default "c8y_Serial")\n --group string The path in the groups hierarchy where the device is added. PATH contains the name of each group separated by /, that is: main_group/sub_group/.../last_sub_group. If a group does not exist, the import creates the group\n -h, --help help for register-ca\n --iccid string The ICCID of the device (SIM card number). If the ICCID appears in file, the import adds a fragment c8y_Mobile.iccid.\n --id strings Device identifier. Max: 1000 characters. E.g. IMEI (required) (accepts pipeline)\n --name string Device name. Defaults to the external id\n --one-time-password string One Time Password used for initial enrollment. Leave blank for a randomly generated password\n --processingMode string Cumulocity processing mode\n --template string Body template\n --templateVars stringArray Body template variables\n --tenant string The ID of the tenant for which the registration is executed (only allowed for the management tenant)\n --type string Device type (default "thin-edge.io")\n'})}),"\n",(0,r.jsx)(t.h3,{id:"options-inherited-from-parent-commands",children:"Options inherited from parent commands"}),"\n",(0,r.jsx)(t.pre,{children:(0,r.jsx)(t.code,{children:' --abortOnErrors int Abort batch when reaching specified number of errors (default 10)\n --allowEmptyPipe Don\'t fail when piped input is empty (stdin)\n --cache Enable cached responses\n --cacheBodyPaths strings Cache should limit hashing of selected paths in the json body. Empty indicates all values\n --cacheTTL string Cache time-to-live (TTL) as a duration, i.e. 60s, 2m (default "60s")\n -c, --compact Compact instead of pretty-printed output when using json output. Pretty print is the default if output is the terminal\n --confirm Prompt for confirmation\n --confirmText string Custom confirmation text\n --currentPage int Current page which should be returned\n --customQueryParam strings add custom URL query parameters. i.e. --customQueryParam \'withCustomOption=true,myOtherOption=myvalue\'\n --debug Set very verbose log messages\n --delay string delay after each request, i.e. 5ms, 1.2s (default "0ms")\n --delayBefore string delay before each request, i.e. 5ms, 1.2s (default "0ms")\n --dry Dry run. Don\'t send any data to the server\n --dryFormat str
1ing Dry run output format. i.e. json, dump, markdown or curl (default "markdown")\n --examples Show examples for the current command\n --filter stringArray Apply a client side filter to response before returning it to the user\n --flatten flatten json output by replacing nested json properties with properties where their names are represented by dot notation\n -f, --force Do not prompt for confirmation. Ignored when using --confirm\n -H, --header strings custom headers. i.e. --header "Accept: value, AnotherHeader: myvalue"\n --includeAll Include all results by iterating through each page\n -k, --insecure Allow insecure server connections when using SSL\n -l, --logMessage string Add custom message to the activity log\n --maxJobs int Maximum number of jobs. 0 = unlimited (use with caution!)\n --noAccept Ignore Accept header will remove the Accept header from requests, however PUT and POST requests will only see the effect\n --noCache Force disabling of cached responses (overwrites cache setting)\n -M, --noColor Don\'t use colors when displaying log entries on the console\n --noLog Disables the activity log for the current command\n --noProgress Disable progress bars\n --noProxy Ignore the proxy settings\n -n, --nullInput Don\'t read the input (stdin). Useful if using in shell for/while loops\n -o, --output string Output format i.e. table, json, csv, csvheader (default "table")\n --outputFile string Save JSON output to file (after select/view)\n --outputFileRaw string Save raw response to file (before select/view)\n --outputTemplate string jsonnet template to apply to the output\n -p, --pageSize int Maximum results per page (default 5)\n --progress Show progress bar. This will also disable any other verbose output\n --proxy string Proxy setting, i.e. http://10.0.0.1:8080\n -r, --raw Show raw response. This mode will force output=json and view=off\n --retries int Max number of attempts when a failed http call is encountered (default 3)\n --select stringArray Comma separated list of properties to return. wildcards and globstar accepted, i.e. --select \'id,name,type,**.serialNumber\'\n --session string Session configuration\n --sessionMode string Override default session mode for a single command which would normally be disabled\n -P, --sessionPassword string Override session password\n -U, --sessionUsername string Override session username. i.e. peter or t1234/peter (with tenant)\n --silentExit Silent status codes do not affect the exit code\n --silentStatusCodes string Status codes which will not print out an error message\n --timeout string Request timeout duration, i.e. 60s, 2m (default "600s")\n --totalPages int Total number of pages to get\n -v, --verbose Verbose logging\n --view string Use views when displaying data on the terminal. Disable using --view off (default "auto")\n --withError Errors will be printed on stdout instead of stderr\n --withTotalElements Request Cumulocity to include the total elements in the response statistics under .statistics.totalElements (introduced in 10.13)\n -t, --withTotalPages Request Cumulocity to include the total pages in the response statistics under .statistics.totalPages\n --workers int Number of workers (default 1)\n'})})]})}function u(e={}){const{wrapper:t}={...(0,s.R)(),...e.components};return t?(0,r.jsx)(t,{...e,children:(0,r.jsx)(l,{...e})}):l(e)}},28453(e,t,i){i.d(t,{R:()=>o,x:()=>a});var n=i(96540);const r={},s=n.createContext(r);function o(e){const t=n.useContext(s);return n.useMemo((function(){return"function"==typeof e?e(t):{...t,...e}}),[t,e])}function a(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:o(e.components),n.createElement(s.Provider,{value:t},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.