다음을 통해 공유


ca-certificate

현재 Azure Sphere 테넌트에 대한 CA(인증 기관) 인증서를 관리합니다. 자세한 내용은 테넌트 CA 인증서 관리를 참조하세요.

작업 설명
다운로드 현재 Azure Sphere 테넌트에 대한 CA 인증서를 X.509 .cer 파일로 다운로드합니다.
download-chain 현재 Azure Sphere 테넌트에 대한 CA 인증서 체인을 PKCS#7 .p7b 파일로 다운로드합니다.
다운로드 증명 현재 Azure Sphere 테넌트용 소유 증명 인증서를 X.509 .cer 파일로 다운로드합니다.
목록 현재 Azure Sphere 테넌트용 모든 인증서를 나열합니다.

다운로드

현재 Azure Sphere 테넌트에 대한 CA 인증서를 X.509 .cer 파일로 다운로드합니다.

필수 매개 변수

매개 변수 형식 설명
--대상 문자열 테넌트 CA 인증서를 저장할 경로 및 파일 이름을 지정합니다. 파일 경로는 절대 또는 상대 경로일 수 있지만 .cer 확장명이 있어야 합니다.

선택적 매개 변수

매개 변수 형식 설명
--인덱스 정수 다운로드할 인증서의 인덱스를 지정합니다. 를 실행 azsphere ca-certificate list 하여 인증서 및 인덱스 값을 나열합니다. 인덱스가 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
--지문 문자열 다운로드할 인증서의 지문을 지정합니다. 를 실행 azsphere ca-certificate list 하여 인증서 및 지문 값을 나열합니다. 지문이 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
-t, --tenant GUID 또는 이름 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.
전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수 설명
--디버그 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다.
-h, --help 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors 오류만 표시하고 경고를 표시하지 않습니다.
-o, --output 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요.
--쿼리 JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서Azure CLI 명령 출력 쿼리 를 참조하세요.
--자세한 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug .

참고

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

필요한 인증서를 다운로드하는 인덱스 지정 예제:

azsphere ca-certificate download --destination ca-cert.cer --index 1

필요한 인증서를 다운로드하기 위해 지문을 지정하는 예제:

azsphere ca-certificate download --destination ca-cert.cer --thumbprint <value>

다음과 같은 출력이 표시됩니다.

Succeeded

download-chain

현재 Azure Sphere 테넌트에 대한 CA 인증서 체인을 PKCS#7 .p7b 파일로 다운로드합니다.

필수 매개 변수

매개 변수 형식 설명
--대상 문자열 테넌트 CA 인증서 체인을 저장할 경로 및 파일 이름을 지정합니다. 상대 또는 절대 경로를 제공할 수 있으며 .p7b 확장을 사용해야 합니다.

선택적 매개 변수

매개 변수 형식 설명
--인덱스 정수 다운로드할 인증서의 인덱스를 지정합니다. 를 실행 azsphere ca-certificate list 하여 인증서 및 인덱스 값을 나열합니다. 인덱스가 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
--지문 문자열 다운로드할 인증서의 지문을 지정합니다. 를 실행 azsphere ca-certificate list 하여 인증서 및 지문 값을 나열합니다. 지문이 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
-t, --tenant GUID 또는 이름 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.
전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수 설명
--디버그 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다.
-h, --help 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors 오류만 표시하고 경고를 표시하지 않습니다.
-o, --output 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요.
--쿼리 JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서Azure CLI 명령 출력 쿼리 를 참조하세요.
--자세한 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug .

참고

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

azsphere ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded

다운로드 증명

현재 Azure Sphere 테넌트, 제공된 코드 및 X.509 .cer 파일에 사용할 소유 증명 인증서를 다운로드합니다. 이 인증서는 디바이스 인증 및 증명 프로세스의 일부입니다. Azure IoT에서 Azure Sphere 디바이스를 사용하는 방법에 대한 자세한 내용은 Azure Sphere에서 Azure IoT 사용을 참조하세요.

필수 매개 변수

매개 변수 형식 설명
--대상 문자열 소유 증명 인증서를 저장할 경로 및 파일 이름을 지정합니다. 파일 경로는 절대 또는 상대 경로일 수 있지만 .cer 확장명은 사용해야 합니다.
--verification-code 문자열 인증서를 생성할 때 사용할 Azure Sphere Security Service의 확인 코드를 지정합니다.

선택적 매개 변수

매개 변수 형식 설명
--인덱스 정수 다운로드할 인증서의 인덱스를 지정합니다. 를 실행 azsphere ca-certificate list 하여 인증서 및 인덱스 값을 나열합니다. 인덱스가 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
--지문 문자열 다운로드할 인증서의 지문을 지정합니다. 를 실행 azsphere ca-certificate list 하여 인증서 및 지문 값을 나열합니다. 지문이 제공되지 않으면 활성 인증서가 다운로드됩니다. 인덱스 값 또는 지문을 지정할 수 있습니다.
-t, --tenant GUID 또는 이름 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.
전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수 설명
--디버그 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다.
-h, --help 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors 오류만 표시하고 경고를 표시하지 않습니다.
-o, --output 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요.
--쿼리 JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서Azure CLI 명령 출력 쿼리 를 참조하세요.
--자세한 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug .

참고

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

azsphere ca-certificate download-proof --destination validation.cer  --verification-code 123412341234 --index 1
Succeeded

목록

현재 테넌트용 모든 인증서를 나열합니다.

선택적 매개 변수

매개 변수 형식 설명
-t, --tenant GUID 또는 이름 이 작업을 수행할 테넌트 를 지정합니다. 선택한 기본 테넌트 를 재정의합니다. 테넌트 ID 또는 테넌트 이름을 지정할 수 있습니다.
전역 매개 변수

Azure Sphere CLI에 사용할 수 있는 전역 매개 변수는 다음과 같습니다.

매개 변수 설명
--디버그 모든 디버그 로그를 표시하도록 로깅 세부 정보를 늘립니다. 버그가 발견되면 버그 보고서를 제출할 때 플래그가 --debug 켜진 상태에서 생성된 출력을 제공합니다.
-h, --help 명령 및 해당 인수에 대한 CLI 참조 정보를 인쇄하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
--only-show-errors 오류만 표시하고 경고를 표시하지 않습니다.
-o, --output 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), 테이블(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적으로 CLI는 를 출력합니다 table. 사용 가능한 출력 형식에 대한 자세한 내용은 Azure Sphere CLI 명령에 대한 출력 형식을 참조하세요.
--쿼리 JMESPath 쿼리 언어를 사용하여 Azure Sphere Security Services에서 반환된 출력을 필터링합니다. 자세한 내용 및 예제 는 JMESPath 자습서Azure CLI 명령 출력 쿼리 를 참조하세요.
--자세한 작업 중에 Azure Sphere에서 만든 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다. 전체 디버그 로그에 사용합니다 --debug .

참고

Azure Sphere 클래식 CLI를 사용하는 경우 사용 가능한 옵션에 대한 자세한 내용은 전역 매개 변수 를 참조하세요.

예제

기본 테넌트가 선택되지 않은 경우 기본 테넌트 설정 메시지가 표시될 수 있습니다.

azsphere ca-certificate list
 ----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
 Index Thumbprint                               CertificateDetails                                              Status StartDate         EndDate
 =========================================================================================================================================================
 1     <value>                                  CN: Microsoft Azure Sphere <tenant-ID>                          Active 09/06/2020 17:39:40 09/06/2022 17:39:40
                                                O: Microsoft Corporation
                                                L: Redmond
                                                ST: Washington
                                                C: US
 ----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
 2     <value>                                  CN: Microsoft Azure Sphere <tenant-ID>                          Ready 29/04/2020 22:51:47 29/04/2022 22:51:47
                                                O: Microsoft Corporation
                                                L: Redmond
                                                ST: Washington
                                                C: US
 ----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------