Red Hat Summit18.8. 클라이언트 작업
클라이언트 생성
클라이언트끝점에서create명령을 실행하여 새 클라이언트를 생성합니다.예를 들면 다음과 같습니다.
kcadm.sh create clients -r demorealm -s clientId=myapp -s enabled=true
$ kcadm.sh create clients -r demorealm -s clientId=myapp -s enabled=trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow 인증할 어댑터의 시크릿을 설정하는 경우 시크릿을 지정합니다.
예를 들면 다음과 같습니다.
kcadm.sh create clients -r demorealm -s clientId=myapp -s enabled=true -s clientAuthenticatorType=client-secret -s secret=d0b8122f-8dfb-46b7-b68a-f5cc4e25d000
$ kcadm.sh create clients -r demorealm -s clientId=myapp -s enabled=true -s clientAuthenticatorType=client-secret -s secret=d0b8122f-8dfb-46b7-b68a-f5cc4e25d000Copy to Clipboard Copied! Toggle word wrap Toggle overflow
클라이언트 나열
clients 끝점에서 get 명령을 사용하여 클라이언트를 나열합니다.
이 예제에서는 출력을 필터링하여 id 및 clientId 속성만 나열합니다.
kcadm.sh get clients -r demorealm --fields id,clientId
$ kcadm.sh get clients -r demorealm --fields id,clientId특정 클라이언트 가져오기
클라이언트 ID를 사용하여 클라이언트 /ID 와 같은 특정 클라이언트를 대상으로 하는 끝점 URI를 구성합니다.
예를 들면 다음과 같습니다.
kcadm.sh get clients/c7b8547f-e748-4333-95d0-410b76b3f4a3 -r demorealm
$ kcadm.sh get clients/c7b8547f-e748-4333-95d0-410b76b3f4a3 -r demorealm특정 클라이언트의 현재 보안 가져오기
클라이언트 ID를 사용하여 클라이언트/ID/client-secret 과 같은 끝점 URI를 구성합니다.
예를 들면 다음과 같습니다.
kcadm.sh get clients/$CID/client-secret
$ kcadm.sh get clients/$CID/client-secret특정 클라이언트에 대한 새 보안 생성
클라이언트 ID를 사용하여 클라이언트/ID/client-secret 과 같은 끝점 URI를 구성합니다.
예를 들면 다음과 같습니다.
kcadm.sh create clients/$CID/client-secret
$ kcadm.sh create clients/$CID/client-secret특정 클라이언트의 현재 보안 업데이트
클라이언트 ID를 사용하여 클라이언트/ID 와 같은 끝점 URI를 구성합니다.
예를 들면 다음과 같습니다.
kcadm.sh update clients/$CID -s "secret=newSecret"
$ kcadm.sh update clients/$CID -s "secret=newSecret"특정 클라이언트의 어댑터 구성 파일(keycloak.json) 가져오기
클라이언트 ID를 사용하여 client/ ID/installation/providers/keycloakc-keycloak-json 과 같은 특정 클라이언트를 대상으로 하는 끝점 URI를 구성합니다.
예를 들면 다음과 같습니다.
kcadm.sh get clients/c7b8547f-e748-4333-95d0-410b76b3f4a3/installation/providers/keycloak-oidc-keycloak-json -r demorealm
$ kcadm.sh get clients/c7b8547f-e748-4333-95d0-410b76b3f4a3/installation/providers/keycloak-oidc-keycloak-json -r demorealm특정 클라이언트에 대한 WildFly 하위 시스템 어댑터 구성 가져오기
클라이언트 ID를 사용하여 clients/ID/installation/providers/keycloak-oidc-jboss-subsystem 과 같은 특정 클라이언트를 대상으로 하는 엔드포인트 URI를 구성합니다.
예를 들면 다음과 같습니다.
kcadm.sh get clients/c7b8547f-e748-4333-95d0-410b76b3f4a3/installation/providers/keycloak-oidc-jboss-subsystem -r demorealm
$ kcadm.sh get clients/c7b8547f-e748-4333-95d0-410b76b3f4a3/installation/providers/keycloak-oidc-jboss-subsystem -r demorealm특정 클라이언트의 Docker-v2 예제 구성 가져오기
클라이언트 ID를 사용하여 client/ ID/installation/providers/docker-v2-compose-yaml yaml 과 같은 특정 클라이언트를 대상으로 하는 끝점 URI를 구성합니다.
응답은 .zip 형식입니다.
예를 들면 다음과 같습니다.
kcadm.sh get http://localhost:8080/auth/admin/realms/demorealm/clients/8f271c35-44e3-446f-8953-b0893810ebe7/installation/providers/docker-v2-compose-yaml -r demorealm > keycloak-docker-compose-yaml.zip
$ kcadm.sh get http://localhost:8080/auth/admin/realms/demorealm/clients/8f271c35-44e3-446f-8953-b0893810ebe7/installation/providers/docker-v2-compose-yaml -r demorealm > keycloak-docker-compose-yaml.zip클라이언트 업데이트
특정 클라이언트를 가져오는 데 사용하는 것과 동일한 끝점 URI로 update 명령을 사용합니다.
예를 들면 다음과 같습니다.
- Linux:
kcadm.sh update clients/c7b8547f-e748-4333-95d0-410b76b3f4a3 -r demorealm -s enabled=false -s publicClient=true -s 'redirectUris=["http://localhost:8080/myapp/*"]' -s baseUrl=http://localhost:8080/myapp -s adminUrl=http://localhost:8080/myapp
$ kcadm.sh update clients/c7b8547f-e748-4333-95d0-410b76b3f4a3 -r demorealm -s enabled=false -s publicClient=true -s 'redirectUris=["http://localhost:8080/myapp/*"]' -s baseUrl=http://localhost:8080/myapp -s adminUrl=http://localhost:8080/myapp- Windows:
kcadm update clients/c7b8547f-e748-4333-95d0-410b76b3f4a3 -r demorealm -s enabled=false -s publicClient=true -s "redirectUris=[\"http://localhost:8080/myapp/*\"]" -s baseUrl=http://localhost:8080/myapp -s adminUrl=http://localhost:8080/myapp
c:\> kcadm update clients/c7b8547f-e748-4333-95d0-410b76b3f4a3 -r demorealm -s enabled=false -s publicClient=true -s "redirectUris=[\"http://localhost:8080/myapp/*\"]" -s baseUrl=http://localhost:8080/myapp -s adminUrl=http://localhost:8080/myapp클라이언트 삭제
특정 클라이언트를 가져오는 데 사용하는 것과 동일한 끝점 URI로 delete 명령을 사용합니다.
예를 들면 다음과 같습니다.
kcadm.sh delete clients/c7b8547f-e748-4333-95d0-410b76b3f4a3 -r demorealm
$ kcadm.sh delete clients/c7b8547f-e748-4333-95d0-410b76b3f4a3 -r demorealm클라이언트 서비스 계정에 대한 역할 추가 또는 제거
클라이언트의 서비스 계정은 사용자 이름 service-account-CLIENT_ID 가 있는 사용자 계정입니다. 이 계정에서 일반 계정과 동일한 사용자 작업을 수행할 수 있습니다.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}