You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2579 lines
92 KiB

  1. """Test the keycloak admin object."""
  2. import copy
  3. from typing import Tuple
  4. import freezegun
  5. import pytest
  6. from dateutil import parser as datetime_parser
  7. import keycloak
  8. from keycloak import KeycloakAdmin, KeycloakOpenID
  9. from keycloak.connection import ConnectionManager
  10. from keycloak.exceptions import (
  11. KeycloakAuthenticationError,
  12. KeycloakDeleteError,
  13. KeycloakGetError,
  14. KeycloakPostError,
  15. KeycloakPutError,
  16. )
  17. def test_keycloak_version():
  18. """Test version."""
  19. assert keycloak.__version__, keycloak.__version__
  20. def test_keycloak_admin_init(env):
  21. """Test keycloak admin init.
  22. :param env: Environment fixture
  23. :type env: KeycloakTestEnv
  24. """
  25. admin = KeycloakAdmin(
  26. server_url=f"http://{env.KEYCLOAK_HOST}:{env.KEYCLOAK_PORT}",
  27. username=env.KEYCLOAK_ADMIN,
  28. password=env.KEYCLOAK_ADMIN_PASSWORD,
  29. )
  30. assert admin.server_url == f"http://{env.KEYCLOAK_HOST}:{env.KEYCLOAK_PORT}", admin.server_url
  31. assert admin.realm_name == "master", admin.realm_name
  32. assert isinstance(admin.connection, ConnectionManager), type(admin.connection)
  33. assert admin.client_id == "admin-cli", admin.client_id
  34. assert admin.client_secret_key is None, admin.client_secret_key
  35. assert admin.verify, admin.verify
  36. assert admin.username == env.KEYCLOAK_ADMIN, admin.username
  37. assert admin.password == env.KEYCLOAK_ADMIN_PASSWORD, admin.password
  38. assert admin.totp is None, admin.totp
  39. assert admin.token is not None, admin.token
  40. assert admin.auto_refresh_token == list(), admin.auto_refresh_token
  41. assert admin.user_realm_name is None, admin.user_realm_name
  42. assert admin.custom_headers is None, admin.custom_headers
  43. assert admin.token
  44. admin = KeycloakAdmin(
  45. server_url=f"http://{env.KEYCLOAK_HOST}:{env.KEYCLOAK_PORT}",
  46. username=env.KEYCLOAK_ADMIN,
  47. password=env.KEYCLOAK_ADMIN_PASSWORD,
  48. realm_name=None,
  49. user_realm_name="master",
  50. )
  51. assert admin.token
  52. admin = KeycloakAdmin(
  53. server_url=f"http://{env.KEYCLOAK_HOST}:{env.KEYCLOAK_PORT}",
  54. username=env.KEYCLOAK_ADMIN,
  55. password=env.KEYCLOAK_ADMIN_PASSWORD,
  56. realm_name=None,
  57. user_realm_name=None,
  58. )
  59. assert admin.token
  60. token = admin.token
  61. admin = KeycloakAdmin(
  62. server_url=f"http://{env.KEYCLOAK_HOST}:{env.KEYCLOAK_PORT}",
  63. token=token,
  64. realm_name=None,
  65. user_realm_name=None,
  66. )
  67. assert admin.token == token
  68. admin.create_realm(payload={"realm": "authz", "enabled": True})
  69. admin.realm_name = "authz"
  70. admin.create_client(
  71. payload={
  72. "name": "authz-client",
  73. "clientId": "authz-client",
  74. "authorizationServicesEnabled": True,
  75. "serviceAccountsEnabled": True,
  76. "clientAuthenticatorType": "client-secret",
  77. "directAccessGrantsEnabled": False,
  78. "enabled": True,
  79. "implicitFlowEnabled": False,
  80. "publicClient": False,
  81. }
  82. )
  83. secret = admin.generate_client_secrets(client_id=admin.get_client_id("authz-client"))
  84. assert KeycloakAdmin(
  85. server_url=f"http://{env.KEYCLOAK_HOST}:{env.KEYCLOAK_PORT}",
  86. user_realm_name="authz",
  87. client_id="authz-client",
  88. client_secret_key=secret["value"],
  89. ).token
  90. admin.delete_realm(realm_name="authz")
  91. assert (
  92. KeycloakAdmin(
  93. server_url=f"http://{env.KEYCLOAK_HOST}:{env.KEYCLOAK_PORT}",
  94. username=None,
  95. password=None,
  96. client_secret_key=None,
  97. custom_headers={"custom": "header"},
  98. ).token
  99. is None
  100. )
  101. def test_realms(admin: KeycloakAdmin):
  102. """Test realms.
  103. :param admin: Keycloak Admin client
  104. :type admin: KeycloakAdmin
  105. """
  106. # Get realms
  107. realms = admin.get_realms()
  108. assert len(realms) == 1, realms
  109. assert "master" == realms[0]["realm"]
  110. # Create a test realm
  111. res = admin.create_realm(payload={"realm": "test"})
  112. assert res == b"", res
  113. # Create the same realm, should fail
  114. with pytest.raises(KeycloakPostError) as err:
  115. res = admin.create_realm(payload={"realm": "test"})
  116. assert err.match('409: b\'{"errorMessage":"Conflict detected. See logs for details"}\'')
  117. # Create the same realm, skip_exists true
  118. res = admin.create_realm(payload={"realm": "test"}, skip_exists=True)
  119. assert res == {"msg": "Already exists"}, res
  120. # Get a single realm
  121. res = admin.get_realm(realm_name="test")
  122. assert res["realm"] == "test"
  123. # Get non-existing realm
  124. with pytest.raises(KeycloakGetError) as err:
  125. admin.get_realm(realm_name="non-existent")
  126. assert err.match('404: b\'{"error":"Realm not found."}\'')
  127. # Update realm
  128. res = admin.update_realm(realm_name="test", payload={"accountTheme": "test"})
  129. assert res == dict(), res
  130. # Check that the update worked
  131. res = admin.get_realm(realm_name="test")
  132. assert res["realm"] == "test"
  133. assert res["accountTheme"] == "test"
  134. # Update wrong payload
  135. with pytest.raises(KeycloakPutError) as err:
  136. admin.update_realm(realm_name="test", payload={"wrong": "payload"})
  137. assert err.match('400: b\'{"error":"Unrecognized field')
  138. # Check that get realms returns both realms
  139. realms = admin.get_realms()
  140. realm_names = [x["realm"] for x in realms]
  141. assert len(realms) == 2, realms
  142. assert "master" in realm_names, realm_names
  143. assert "test" in realm_names, realm_names
  144. # Delete the realm
  145. res = admin.delete_realm(realm_name="test")
  146. assert res == dict(), res
  147. # Check that the realm does not exist anymore
  148. with pytest.raises(KeycloakGetError) as err:
  149. admin.get_realm(realm_name="test")
  150. assert err.match('404: b\'{"error":"Realm not found."}\'')
  151. # Delete non-existing realm
  152. with pytest.raises(KeycloakDeleteError) as err:
  153. admin.delete_realm(realm_name="non-existent")
  154. assert err.match('404: b\'{"error":"Realm not found."}\'')
  155. def test_import_export_realms(admin: KeycloakAdmin, realm: str):
  156. """Test import and export of realms.
  157. :param admin: Keycloak Admin client
  158. :type admin: KeycloakAdmin
  159. :param realm: Keycloak realm
  160. :type realm: str
  161. """
  162. admin.realm_name = realm
  163. realm_export = admin.export_realm(export_clients=True, export_groups_and_role=True)
  164. assert realm_export != dict(), realm_export
  165. admin.delete_realm(realm_name=realm)
  166. admin.realm_name = "master"
  167. res = admin.import_realm(payload=realm_export)
  168. assert res == b"", res
  169. # Test bad import
  170. with pytest.raises(KeycloakPostError) as err:
  171. admin.import_realm(payload=dict())
  172. assert err.match('500: b\'{"error":"unknown_error"}\'')
  173. def test_users(admin: KeycloakAdmin, realm: str):
  174. """Test users.
  175. :param admin: Keycloak Admin client
  176. :type admin: KeycloakAdmin
  177. :param realm: Keycloak realm
  178. :type realm: str
  179. """
  180. admin.realm_name = realm
  181. # Check no users present
  182. users = admin.get_users()
  183. assert users == list(), users
  184. # Test create user
  185. user_id = admin.create_user(payload={"username": "test", "email": "test@test.test"})
  186. assert user_id is not None, user_id
  187. # Test create the same user
  188. with pytest.raises(KeycloakPostError) as err:
  189. admin.create_user(payload={"username": "test", "email": "test@test.test"})
  190. assert err.match('409: b\'{"errorMessage":"User exists with same username"}\'')
  191. # Test create the same user, exists_ok true
  192. user_id_2 = admin.create_user(
  193. payload={"username": "test", "email": "test@test.test"}, exist_ok=True
  194. )
  195. assert user_id == user_id_2
  196. # Test get user
  197. user = admin.get_user(user_id=user_id)
  198. assert user["username"] == "test", user["username"]
  199. assert user["email"] == "test@test.test", user["email"]
  200. # Test update user
  201. res = admin.update_user(user_id=user_id, payload={"firstName": "Test"})
  202. assert res == dict(), res
  203. user = admin.get_user(user_id=user_id)
  204. assert user["firstName"] == "Test"
  205. # Test update user fail
  206. with pytest.raises(KeycloakPutError) as err:
  207. admin.update_user(user_id=user_id, payload={"wrong": "payload"})
  208. assert err.match('400: b\'{"error":"Unrecognized field')
  209. # Test get users again
  210. users = admin.get_users()
  211. usernames = [x["username"] for x in users]
  212. assert "test" in usernames
  213. # Test users counts
  214. count = admin.users_count()
  215. assert count == 1, count
  216. # Test users count with query
  217. count = admin.users_count(query={"username": "notpresent"})
  218. assert count == 0
  219. # Test user groups
  220. groups = admin.get_user_groups(user_id=user["id"])
  221. assert len(groups) == 0
  222. # Test user groups bad id
  223. with pytest.raises(KeycloakGetError) as err:
  224. admin.get_user_groups(user_id="does-not-exist")
  225. assert err.match('404: b\'{"error":"User not found"}\'')
  226. # Test logout
  227. res = admin.user_logout(user_id=user["id"])
  228. assert res == dict(), res
  229. # Test logout fail
  230. with pytest.raises(KeycloakPostError) as err:
  231. admin.user_logout(user_id="non-existent-id")
  232. assert err.match('404: b\'{"error":"User not found"}\'')
  233. # Test consents
  234. res = admin.user_consents(user_id=user["id"])
  235. assert len(res) == 0, res
  236. # Test consents fail
  237. with pytest.raises(KeycloakGetError) as err:
  238. admin.user_consents(user_id="non-existent-id")
  239. assert err.match('404: b\'{"error":"User not found"}\'')
  240. # Test delete user
  241. res = admin.delete_user(user_id=user_id)
  242. assert res == dict(), res
  243. with pytest.raises(KeycloakGetError) as err:
  244. admin.get_user(user_id=user_id)
  245. err.match('404: b\'{"error":"User not found"}\'')
  246. # Test delete fail
  247. with pytest.raises(KeycloakDeleteError) as err:
  248. admin.delete_user(user_id="non-existent-id")
  249. assert err.match('404: b\'{"error":"User not found"}\'')
  250. def test_users_pagination(admin: KeycloakAdmin, realm: str):
  251. """Test user pagination.
  252. :param admin: Keycloak Admin client
  253. :type admin: KeycloakAdmin
  254. :param realm: Keycloak realm
  255. :type realm: str
  256. """
  257. admin.realm_name = realm
  258. for ind in range(admin.PAGE_SIZE + 50):
  259. username = f"user_{ind}"
  260. admin.create_user(payload={"username": username, "email": f"{username}@test.test"})
  261. users = admin.get_users()
  262. assert len(users) == admin.PAGE_SIZE + 50, len(users)
  263. users = admin.get_users(query={"first": 100})
  264. assert len(users) == 50, len(users)
  265. users = admin.get_users(query={"max": 20})
  266. assert len(users) == 20, len(users)
  267. def test_idps(admin: KeycloakAdmin, realm: str):
  268. """Test IDPs.
  269. :param admin: Keycloak Admin client
  270. :type admin: KeycloakAdmin
  271. :param realm: Keycloak realm
  272. :type realm: str
  273. """
  274. admin.realm_name = realm
  275. # Create IDP
  276. res = admin.create_idp(
  277. payload=dict(
  278. providerId="github", alias="github", config=dict(clientId="test", clientSecret="test")
  279. )
  280. )
  281. assert res == b"", res
  282. # Test create idp fail
  283. with pytest.raises(KeycloakPostError) as err:
  284. admin.create_idp(payload={"providerId": "does-not-exist", "alias": "something"})
  285. assert err.match("Invalid identity provider id"), err
  286. # Test listing
  287. idps = admin.get_idps()
  288. assert len(idps) == 1
  289. assert "github" == idps[0]["alias"]
  290. # Test IdP update
  291. res = admin.update_idp(idp_alias="github", payload=idps[0])
  292. assert res == {}, res
  293. # Test adding a mapper
  294. res = admin.add_mapper_to_idp(
  295. idp_alias="github",
  296. payload={
  297. "identityProviderAlias": "github",
  298. "identityProviderMapper": "github-user-attribute-mapper",
  299. "name": "test",
  300. },
  301. )
  302. assert res == b"", res
  303. # Test mapper fail
  304. with pytest.raises(KeycloakPostError) as err:
  305. admin.add_mapper_to_idp(idp_alias="does-no-texist", payload=dict())
  306. assert err.match('404: b\'{"error":"HTTP 404 Not Found"}\'')
  307. # Test IdP mappers listing
  308. idp_mappers = admin.get_idp_mappers(idp_alias="github")
  309. assert len(idp_mappers) == 1
  310. # Test IdP mapper update
  311. res = admin.update_mapper_in_idp(
  312. idp_alias="github",
  313. mapper_id=idp_mappers[0]["id"],
  314. # For an obscure reason, keycloak expect all fields
  315. payload={
  316. "id": idp_mappers[0]["id"],
  317. "identityProviderAlias": "github-alias",
  318. "identityProviderMapper": "github-user-attribute-mapper",
  319. "name": "test",
  320. "config": idp_mappers[0]["config"],
  321. },
  322. )
  323. assert res == dict(), res
  324. # Test delete
  325. res = admin.delete_idp(idp_alias="github")
  326. assert res == dict(), res
  327. # Test delete fail
  328. with pytest.raises(KeycloakDeleteError) as err:
  329. admin.delete_idp(idp_alias="does-not-exist")
  330. assert err.match('404: b\'{"error":"HTTP 404 Not Found"}\'')
  331. def test_user_credentials(admin: KeycloakAdmin, user: str):
  332. """Test user credentials.
  333. :param admin: Keycloak Admin client
  334. :type admin: KeycloakAdmin
  335. :param user: Keycloak user
  336. :type user: str
  337. """
  338. res = admin.set_user_password(user_id=user, password="booya", temporary=True)
  339. assert res == dict(), res
  340. # Test user password set fail
  341. with pytest.raises(KeycloakPutError) as err:
  342. admin.set_user_password(user_id="does-not-exist", password="")
  343. assert err.match('404: b\'{"error":"User not found"}\'')
  344. credentials = admin.get_credentials(user_id=user)
  345. assert len(credentials) == 1
  346. assert credentials[0]["type"] == "password", credentials
  347. # Test get credentials fail
  348. with pytest.raises(KeycloakGetError) as err:
  349. admin.get_credentials(user_id="does-not-exist")
  350. assert err.match('404: b\'{"error":"User not found"}\'')
  351. res = admin.delete_credential(user_id=user, credential_id=credentials[0]["id"])
  352. assert res == dict(), res
  353. # Test delete fail
  354. with pytest.raises(KeycloakDeleteError) as err:
  355. admin.delete_credential(user_id=user, credential_id="does-not-exist")
  356. assert err.match('404: b\'{"error":"Credential not found"}\'')
  357. def test_social_logins(admin: KeycloakAdmin, user: str):
  358. """Test social logins.
  359. :param admin: Keycloak Admin client
  360. :type admin: KeycloakAdmin
  361. :param user: Keycloak user
  362. :type user: str
  363. """
  364. res = admin.add_user_social_login(
  365. user_id=user, provider_id="gitlab", provider_userid="test", provider_username="test"
  366. )
  367. assert res == dict(), res
  368. admin.add_user_social_login(
  369. user_id=user, provider_id="github", provider_userid="test", provider_username="test"
  370. )
  371. assert res == dict(), res
  372. # Test add social login fail
  373. with pytest.raises(KeycloakPostError) as err:
  374. admin.add_user_social_login(
  375. user_id="does-not-exist",
  376. provider_id="does-not-exist",
  377. provider_userid="test",
  378. provider_username="test",
  379. )
  380. assert err.match('404: b\'{"error":"User not found"}\'')
  381. res = admin.get_user_social_logins(user_id=user)
  382. assert res == list(), res
  383. # Test get social logins fail
  384. with pytest.raises(KeycloakGetError) as err:
  385. admin.get_user_social_logins(user_id="does-not-exist")
  386. assert err.match('404: b\'{"error":"User not found"}\'')
  387. res = admin.delete_user_social_login(user_id=user, provider_id="gitlab")
  388. assert res == {}, res
  389. res = admin.delete_user_social_login(user_id=user, provider_id="github")
  390. assert res == {}, res
  391. with pytest.raises(KeycloakDeleteError) as err:
  392. admin.delete_user_social_login(user_id=user, provider_id="instagram")
  393. assert err.match('404: b\'{"error":"Link not found"}\''), err
  394. def test_server_info(admin: KeycloakAdmin):
  395. """Test server info.
  396. :param admin: Keycloak Admin client
  397. :type admin: KeycloakAdmin
  398. """
  399. info = admin.get_server_info()
  400. assert set(info.keys()).issubset(
  401. {
  402. "systemInfo",
  403. "memoryInfo",
  404. "profileInfo",
  405. "themes",
  406. "socialProviders",
  407. "identityProviders",
  408. "providers",
  409. "protocolMapperTypes",
  410. "builtinProtocolMappers",
  411. "clientInstallations",
  412. "componentTypes",
  413. "passwordPolicies",
  414. "enums",
  415. "cryptoInfo",
  416. }
  417. ), info.keys()
  418. def test_groups(admin: KeycloakAdmin, user: str):
  419. """Test groups.
  420. :param admin: Keycloak Admin client
  421. :type admin: KeycloakAdmin
  422. :param user: Keycloak user
  423. :type user: str
  424. """
  425. # Test get groups
  426. groups = admin.get_groups()
  427. assert len(groups) == 0
  428. # Test create group
  429. group_id = admin.create_group(payload={"name": "main-group"})
  430. assert group_id is not None, group_id
  431. # Test create subgroups
  432. subgroup_id_1 = admin.create_group(payload={"name": "subgroup-1"}, parent=group_id)
  433. subgroup_id_2 = admin.create_group(payload={"name": "subgroup-2"}, parent=group_id)
  434. # Test create group fail
  435. with pytest.raises(KeycloakPostError) as err:
  436. admin.create_group(payload={"name": "subgroup-1"}, parent=group_id)
  437. assert err.match('409: b\'{"error":"unknown_error"}\''), err
  438. # Test skip exists OK
  439. subgroup_id_1_eq = admin.create_group(
  440. payload={"name": "subgroup-1"}, parent=group_id, skip_exists=True
  441. )
  442. assert subgroup_id_1_eq is None
  443. # Test get groups again
  444. groups = admin.get_groups()
  445. assert len(groups) == 1, groups
  446. assert len(groups[0]["subGroups"]) == 2, groups["subGroups"]
  447. assert groups[0]["id"] == group_id
  448. assert {x["id"] for x in groups[0]["subGroups"]} == {subgroup_id_1, subgroup_id_2}
  449. # Test get groups query
  450. groups = admin.get_groups(query={"max": 10})
  451. assert len(groups) == 1, groups
  452. assert len(groups[0]["subGroups"]) == 2, groups["subGroups"]
  453. assert groups[0]["id"] == group_id
  454. assert {x["id"] for x in groups[0]["subGroups"]} == {subgroup_id_1, subgroup_id_2}
  455. # Test get group
  456. res = admin.get_group(group_id=subgroup_id_1)
  457. assert res["id"] == subgroup_id_1, res
  458. assert res["name"] == "subgroup-1"
  459. assert res["path"] == "/main-group/subgroup-1"
  460. # Test get group fail
  461. with pytest.raises(KeycloakGetError) as err:
  462. admin.get_group(group_id="does-not-exist")
  463. assert err.match('404: b\'{"error":"Could not find group by id"}\''), err
  464. # Create 1 more subgroup
  465. subsubgroup_id_1 = admin.create_group(payload={"name": "subsubgroup-1"}, parent=subgroup_id_2)
  466. main_group = admin.get_group(group_id=group_id)
  467. # Test nested searches
  468. res = admin.get_subgroups(group=main_group, path="/main-group/subgroup-2/subsubgroup-1")
  469. assert res is not None, res
  470. assert res["id"] == subsubgroup_id_1
  471. # Test empty search
  472. res = admin.get_subgroups(group=main_group, path="/none")
  473. assert res is None, res
  474. # Test get group by path
  475. res = admin.get_group_by_path(path="/main-group/subgroup-1")
  476. assert res is not None, res
  477. assert res["id"] == subgroup_id_1, res
  478. with pytest.raises(KeycloakGetError) as err:
  479. admin.get_group_by_path(path="/main-group/subgroup-2/subsubgroup-1/test")
  480. assert err.match('404: b\'{"error":"Group path does not exist"}\'')
  481. res = admin.get_group_by_path(path="/main-group/subgroup-2/subsubgroup-1")
  482. assert res is not None, res
  483. assert res["id"] == subsubgroup_id_1
  484. res = admin.get_group_by_path(path="/main-group")
  485. assert res is not None, res
  486. assert res["id"] == group_id, res
  487. # Test group members
  488. res = admin.get_group_members(group_id=subgroup_id_2)
  489. assert len(res) == 0, res
  490. # Test fail group members
  491. with pytest.raises(KeycloakGetError) as err:
  492. admin.get_group_members(group_id="does-not-exist")
  493. assert err.match('404: b\'{"error":"Could not find group by id"}\'')
  494. res = admin.group_user_add(user_id=user, group_id=subgroup_id_2)
  495. assert res == dict(), res
  496. res = admin.get_group_members(group_id=subgroup_id_2)
  497. assert len(res) == 1, res
  498. assert res[0]["id"] == user
  499. # Test get group members query
  500. res = admin.get_group_members(group_id=subgroup_id_2, query={"max": 10})
  501. assert len(res) == 1, res
  502. assert res[0]["id"] == user
  503. with pytest.raises(KeycloakDeleteError) as err:
  504. admin.group_user_remove(user_id="does-not-exist", group_id=subgroup_id_2)
  505. assert err.match('404: b\'{"error":"User not found"}\''), err
  506. res = admin.group_user_remove(user_id=user, group_id=subgroup_id_2)
  507. assert res == dict(), res
  508. # Test set permissions
  509. res = admin.group_set_permissions(group_id=subgroup_id_2, enabled=True)
  510. assert res["enabled"], res
  511. res = admin.group_set_permissions(group_id=subgroup_id_2, enabled=False)
  512. assert not res["enabled"], res
  513. with pytest.raises(KeycloakPutError) as err:
  514. admin.group_set_permissions(group_id=subgroup_id_2, enabled="blah")
  515. assert err.match('500: b\'{"error":"unknown_error"}\''), err
  516. # Test update group
  517. res = admin.update_group(group_id=subgroup_id_2, payload={"name": "new-subgroup-2"})
  518. assert res == dict(), res
  519. assert admin.get_group(group_id=subgroup_id_2)["name"] == "new-subgroup-2"
  520. # test update fail
  521. with pytest.raises(KeycloakPutError) as err:
  522. admin.update_group(group_id="does-not-exist", payload=dict())
  523. assert err.match('404: b\'{"error":"Could not find group by id"}\''), err
  524. # Test delete
  525. res = admin.delete_group(group_id=group_id)
  526. assert res == dict(), res
  527. assert len(admin.get_groups()) == 0
  528. # Test delete fail
  529. with pytest.raises(KeycloakDeleteError) as err:
  530. admin.delete_group(group_id="does-not-exist")
  531. assert err.match('404: b\'{"error":"Could not find group by id"}\''), err
  532. def test_clients(admin: KeycloakAdmin, realm: str):
  533. """Test clients.
  534. :param admin: Keycloak Admin client
  535. :type admin: KeycloakAdmin
  536. :param realm: Keycloak realm
  537. :type realm: str
  538. """
  539. admin.realm_name = realm
  540. # Test get clients
  541. clients = admin.get_clients()
  542. assert len(clients) == 6, clients
  543. assert {x["name"] for x in clients} == set(
  544. [
  545. "${client_admin-cli}",
  546. "${client_security-admin-console}",
  547. "${client_account-console}",
  548. "${client_broker}",
  549. "${client_account}",
  550. "${client_realm-management}",
  551. ]
  552. ), clients
  553. # Test create client
  554. client_id = admin.create_client(payload={"name": "test-client", "clientId": "test-client"})
  555. assert client_id, client_id
  556. with pytest.raises(KeycloakPostError) as err:
  557. admin.create_client(payload={"name": "test-client", "clientId": "test-client"})
  558. assert err.match('409: b\'{"errorMessage":"Client test-client already exists"}\''), err
  559. client_id_2 = admin.create_client(
  560. payload={"name": "test-client", "clientId": "test-client"}, skip_exists=True
  561. )
  562. assert client_id == client_id_2, client_id_2
  563. # Test get client
  564. res = admin.get_client(client_id=client_id)
  565. assert res["clientId"] == "test-client", res
  566. assert res["name"] == "test-client", res
  567. assert res["id"] == client_id, res
  568. with pytest.raises(KeycloakGetError) as err:
  569. admin.get_client(client_id="does-not-exist")
  570. assert err.match('404: b\'{"error":"Could not find client"}\'')
  571. assert len(admin.get_clients()) == 7
  572. # Test get client id
  573. assert admin.get_client_id(client_id="test-client") == client_id
  574. assert admin.get_client_id(client_id="does-not-exist") is None
  575. # Test update client
  576. res = admin.update_client(client_id=client_id, payload={"name": "test-client-change"})
  577. assert res == dict(), res
  578. with pytest.raises(KeycloakPutError) as err:
  579. admin.update_client(client_id="does-not-exist", payload={"name": "test-client-change"})
  580. assert err.match('404: b\'{"error":"Could not find client"}\'')
  581. # Test client mappers
  582. res = admin.get_mappers_from_client(client_id=client_id)
  583. assert len(res) == 0
  584. with pytest.raises(KeycloakPostError) as err:
  585. admin.add_mapper_to_client(client_id="does-not-exist", payload=dict())
  586. assert err.match('404: b\'{"error":"Could not find client"}\'')
  587. res = admin.add_mapper_to_client(
  588. client_id=client_id,
  589. payload={
  590. "name": "test-mapper",
  591. "protocol": "openid-connect",
  592. "protocolMapper": "oidc-usermodel-attribute-mapper",
  593. },
  594. )
  595. assert res == b""
  596. assert len(admin.get_mappers_from_client(client_id=client_id)) == 1
  597. mapper = admin.get_mappers_from_client(client_id=client_id)[0]
  598. with pytest.raises(KeycloakPutError) as err:
  599. admin.update_client_mapper(client_id=client_id, mapper_id="does-not-exist", payload=dict())
  600. assert err.match('404: b\'{"error":"Model not found"}\'')
  601. mapper["config"]["user.attribute"] = "test"
  602. res = admin.update_client_mapper(client_id=client_id, mapper_id=mapper["id"], payload=mapper)
  603. assert res == dict()
  604. res = admin.remove_client_mapper(client_id=client_id, client_mapper_id=mapper["id"])
  605. assert res == dict()
  606. with pytest.raises(KeycloakDeleteError) as err:
  607. admin.remove_client_mapper(client_id=client_id, client_mapper_id=mapper["id"])
  608. assert err.match('404: b\'{"error":"Model not found"}\'')
  609. # Test client sessions
  610. with pytest.raises(KeycloakGetError) as err:
  611. admin.get_client_all_sessions(client_id="does-not-exist")
  612. assert err.match('404: b\'{"error":"Could not find client"}\'')
  613. assert admin.get_client_all_sessions(client_id=client_id) == list()
  614. assert admin.get_client_sessions_stats() == list()
  615. # Test authz
  616. auth_client_id = admin.create_client(
  617. payload={
  618. "name": "authz-client",
  619. "clientId": "authz-client",
  620. "authorizationServicesEnabled": True,
  621. "serviceAccountsEnabled": True,
  622. }
  623. )
  624. res = admin.get_client_authz_settings(client_id=auth_client_id)
  625. assert res["allowRemoteResourceManagement"]
  626. assert res["decisionStrategy"] == "UNANIMOUS"
  627. assert len(res["policies"]) >= 0
  628. with pytest.raises(KeycloakGetError) as err:
  629. admin.get_client_authz_settings(client_id=client_id)
  630. assert err.match('404: b\'{"error":"HTTP 404 Not Found"}\'')
  631. # Authz resources
  632. res = admin.get_client_authz_resources(client_id=auth_client_id)
  633. assert len(res) == 1
  634. assert res[0]["name"] == "Default Resource"
  635. with pytest.raises(KeycloakGetError) as err:
  636. admin.get_client_authz_resources(client_id=client_id)
  637. assert err.match('404: b\'{"error":"HTTP 404 Not Found"}\'')
  638. res = admin.create_client_authz_resource(
  639. client_id=auth_client_id, payload={"name": "test-resource"}
  640. )
  641. assert res["name"] == "test-resource", res
  642. test_resource_id = res["_id"]
  643. with pytest.raises(KeycloakPostError) as err:
  644. admin.create_client_authz_resource(
  645. client_id=auth_client_id, payload={"name": "test-resource"}
  646. )
  647. assert err.match('409: b\'{"error":"invalid_request"')
  648. assert admin.create_client_authz_resource(
  649. client_id=auth_client_id, payload={"name": "test-resource"}, skip_exists=True
  650. ) == {"msg": "Already exists"}
  651. res = admin.get_client_authz_resources(client_id=auth_client_id)
  652. assert len(res) == 2
  653. assert {x["name"] for x in res} == {"Default Resource", "test-resource"}
  654. # Authz policies
  655. res = admin.get_client_authz_policies(client_id=auth_client_id)
  656. assert len(res) == 1, res
  657. assert res[0]["name"] == "Default Policy"
  658. with pytest.raises(KeycloakGetError) as err:
  659. admin.get_client_authz_policies(client_id="does-not-exist")
  660. assert err.match('404: b\'{"error":"Could not find client"}\'')
  661. role_id = admin.get_realm_role(role_name="offline_access")["id"]
  662. res = admin.create_client_authz_role_based_policy(
  663. client_id=auth_client_id,
  664. payload={"name": "test-authz-rb-policy", "roles": [{"id": role_id}]},
  665. )
  666. assert res["name"] == "test-authz-rb-policy", res
  667. with pytest.raises(KeycloakPostError) as err:
  668. admin.create_client_authz_role_based_policy(
  669. client_id=auth_client_id,
  670. payload={"name": "test-authz-rb-policy", "roles": [{"id": role_id}]},
  671. )
  672. assert err.match('409: b\'{"error":"Policy with name')
  673. assert admin.create_client_authz_role_based_policy(
  674. client_id=auth_client_id,
  675. payload={"name": "test-authz-rb-policy", "roles": [{"id": role_id}]},
  676. skip_exists=True,
  677. ) == {"msg": "Already exists"}
  678. assert len(admin.get_client_authz_policies(client_id=auth_client_id)) == 2
  679. # Test authz permissions
  680. res = admin.get_client_authz_permissions(client_id=auth_client_id)
  681. assert len(res) == 1, res
  682. assert res[0]["name"] == "Default Permission"
  683. with pytest.raises(KeycloakGetError) as err:
  684. admin.get_client_authz_permissions(client_id="does-not-exist")
  685. assert err.match('404: b\'{"error":"Could not find client"}\'')
  686. res = admin.create_client_authz_resource_based_permission(
  687. client_id=auth_client_id,
  688. payload={"name": "test-permission-rb", "resources": [test_resource_id]},
  689. )
  690. assert res, res
  691. assert res["name"] == "test-permission-rb"
  692. assert res["resources"] == [test_resource_id]
  693. with pytest.raises(KeycloakPostError) as err:
  694. admin.create_client_authz_resource_based_permission(
  695. client_id=auth_client_id,
  696. payload={"name": "test-permission-rb", "resources": [test_resource_id]},
  697. )
  698. assert err.match('409: b\'{"error":"Policy with name')
  699. assert admin.create_client_authz_resource_based_permission(
  700. client_id=auth_client_id,
  701. payload={"name": "test-permission-rb", "resources": [test_resource_id]},
  702. skip_exists=True,
  703. ) == {"msg": "Already exists"}
  704. assert len(admin.get_client_authz_permissions(client_id=auth_client_id)) == 2
  705. # Test authz scopes
  706. res = admin.get_client_authz_scopes(client_id=auth_client_id)
  707. assert len(res) == 0, res
  708. with pytest.raises(KeycloakGetError) as err:
  709. admin.get_client_authz_scopes(client_id=client_id)
  710. assert err.match('404: b\'{"error":"HTTP 404 Not Found"}\'')
  711. res = admin.create_client_authz_scopes(
  712. client_id=auth_client_id, payload={"name": "test-authz-scope"}
  713. )
  714. assert res["name"] == "test-authz-scope", res
  715. with pytest.raises(KeycloakPostError) as err:
  716. admin.create_client_authz_scopes(
  717. client_id="invalid_client_id", payload={"name": "test-authz-scope"}
  718. )
  719. assert err.match('404: b\'{"error":"Could not find client"')
  720. assert admin.create_client_authz_scopes(
  721. client_id=auth_client_id, payload={"name": "test-authz-scope"}
  722. )
  723. res = admin.get_client_authz_scopes(client_id=auth_client_id)
  724. assert len(res) == 1
  725. assert {x["name"] for x in res} == {"test-authz-scope"}
  726. # Test service account user
  727. res = admin.get_client_service_account_user(client_id=auth_client_id)
  728. assert res["username"] == "service-account-authz-client", res
  729. with pytest.raises(KeycloakGetError) as err:
  730. admin.get_client_service_account_user(client_id=client_id)
  731. assert err.match('400: b\'{"error":"unknown_error"}\'')
  732. # Test delete client
  733. res = admin.delete_client(client_id=auth_client_id)
  734. assert res == dict(), res
  735. with pytest.raises(KeycloakDeleteError) as err:
  736. admin.delete_client(client_id=auth_client_id)
  737. assert err.match('404: b\'{"error":"Could not find client"}\'')
  738. # Test client credentials
  739. admin.create_client(
  740. payload={
  741. "name": "test-confidential",
  742. "enabled": True,
  743. "protocol": "openid-connect",
  744. "publicClient": False,
  745. "redirectUris": ["http://localhost/*"],
  746. "webOrigins": ["+"],
  747. "clientId": "test-confidential",
  748. "secret": "test-secret",
  749. "clientAuthenticatorType": "client-secret",
  750. }
  751. )
  752. with pytest.raises(KeycloakGetError) as err:
  753. admin.get_client_secrets(client_id="does-not-exist")
  754. assert err.match('404: b\'{"error":"Could not find client"}\'')
  755. secrets = admin.get_client_secrets(
  756. client_id=admin.get_client_id(client_id="test-confidential")
  757. )
  758. assert secrets == {"type": "secret", "value": "test-secret"}
  759. with pytest.raises(KeycloakPostError) as err:
  760. admin.generate_client_secrets(client_id="does-not-exist")
  761. assert err.match('404: b\'{"error":"Could not find client"}\'')
  762. res = admin.generate_client_secrets(
  763. client_id=admin.get_client_id(client_id="test-confidential")
  764. )
  765. assert res
  766. assert (
  767. admin.get_client_secrets(client_id=admin.get_client_id(client_id="test-confidential"))
  768. == res
  769. )
  770. def test_realm_roles(admin: KeycloakAdmin, realm: str):
  771. """Test realm roles.
  772. :param admin: Keycloak Admin client
  773. :type admin: KeycloakAdmin
  774. :param realm: Keycloak realm
  775. :type realm: str
  776. """
  777. admin.realm_name = realm
  778. # Test get realm roles
  779. roles = admin.get_realm_roles()
  780. assert len(roles) == 3, roles
  781. role_names = [x["name"] for x in roles]
  782. assert "uma_authorization" in role_names, role_names
  783. assert "offline_access" in role_names, role_names
  784. # Test empty members
  785. with pytest.raises(KeycloakGetError) as err:
  786. admin.get_realm_role_members(role_name="does-not-exist")
  787. assert err.match('404: b\'{"error":"Could not find role"}\'')
  788. members = admin.get_realm_role_members(role_name="offline_access")
  789. assert members == list(), members
  790. # Test create realm role
  791. role_id = admin.create_realm_role(payload={"name": "test-realm-role"}, skip_exists=True)
  792. assert role_id, role_id
  793. with pytest.raises(KeycloakPostError) as err:
  794. admin.create_realm_role(payload={"name": "test-realm-role"})
  795. assert err.match('409: b\'{"errorMessage":"Role with name test-realm-role already exists"}\'')
  796. role_id_2 = admin.create_realm_role(payload={"name": "test-realm-role"}, skip_exists=True)
  797. assert role_id == role_id_2
  798. # Test update realm role
  799. res = admin.update_realm_role(
  800. role_name="test-realm-role", payload={"name": "test-realm-role-update"}
  801. )
  802. assert res == dict(), res
  803. with pytest.raises(KeycloakPutError) as err:
  804. admin.update_realm_role(
  805. role_name="test-realm-role", payload={"name": "test-realm-role-update"}
  806. )
  807. assert err.match('404: b\'{"error":"Could not find role"}\''), err
  808. # Test realm role user assignment
  809. user_id = admin.create_user(payload={"username": "role-testing", "email": "test@test.test"})
  810. with pytest.raises(KeycloakPostError) as err:
  811. admin.assign_realm_roles(user_id=user_id, roles=["bad"])
  812. assert err.match('500: b\'{"error":"unknown_error"}\'')
  813. res = admin.assign_realm_roles(
  814. user_id=user_id,
  815. roles=[
  816. admin.get_realm_role(role_name="offline_access"),
  817. admin.get_realm_role(role_name="test-realm-role-update"),
  818. ],
  819. )
  820. assert res == dict(), res
  821. assert admin.get_user(user_id=user_id)["username"] in [
  822. x["username"] for x in admin.get_realm_role_members(role_name="offline_access")
  823. ]
  824. assert admin.get_user(user_id=user_id)["username"] in [
  825. x["username"] for x in admin.get_realm_role_members(role_name="test-realm-role-update")
  826. ]
  827. roles = admin.get_realm_roles_of_user(user_id=user_id)
  828. assert len(roles) == 3
  829. assert "offline_access" in [x["name"] for x in roles]
  830. assert "test-realm-role-update" in [x["name"] for x in roles]
  831. with pytest.raises(KeycloakDeleteError) as err:
  832. admin.delete_realm_roles_of_user(user_id=user_id, roles=["bad"])
  833. assert err.match('500: b\'{"error":"unknown_error"}\'')
  834. res = admin.delete_realm_roles_of_user(
  835. user_id=user_id, roles=[admin.get_realm_role(role_name="offline_access")]
  836. )
  837. assert res == dict(), res
  838. assert admin.get_realm_role_members(role_name="offline_access") == list()
  839. roles = admin.get_realm_roles_of_user(user_id=user_id)
  840. assert len(roles) == 2
  841. assert "offline_access" not in [x["name"] for x in roles]
  842. assert "test-realm-role-update" in [x["name"] for x in roles]
  843. roles = admin.get_available_realm_roles_of_user(user_id=user_id)
  844. assert len(roles) == 2
  845. assert "offline_access" in [x["name"] for x in roles]
  846. assert "uma_authorization" in [x["name"] for x in roles]
  847. # Test realm role group assignment
  848. group_id = admin.create_group(payload={"name": "test-group"})
  849. with pytest.raises(KeycloakPostError) as err:
  850. admin.assign_group_realm_roles(group_id=group_id, roles=["bad"])
  851. assert err.match('500: b\'{"error":"unknown_error"}\'')
  852. res = admin.assign_group_realm_roles(
  853. group_id=group_id,
  854. roles=[
  855. admin.get_realm_role(role_name="offline_access"),
  856. admin.get_realm_role(role_name="test-realm-role-update"),
  857. ],
  858. )
  859. assert res == dict(), res
  860. roles = admin.get_group_realm_roles(group_id=group_id)
  861. assert len(roles) == 2
  862. assert "offline_access" in [x["name"] for x in roles]
  863. assert "test-realm-role-update" in [x["name"] for x in roles]
  864. with pytest.raises(KeycloakDeleteError) as err:
  865. admin.delete_group_realm_roles(group_id=group_id, roles=["bad"])
  866. assert err.match('500: b\'{"error":"unknown_error"}\'')
  867. res = admin.delete_group_realm_roles(
  868. group_id=group_id, roles=[admin.get_realm_role(role_name="offline_access")]
  869. )
  870. assert res == dict(), res
  871. roles = admin.get_group_realm_roles(group_id=group_id)
  872. assert len(roles) == 1
  873. assert "test-realm-role-update" in [x["name"] for x in roles]
  874. # Test composite realm roles
  875. composite_role = admin.create_realm_role(payload={"name": "test-composite-role"})
  876. with pytest.raises(KeycloakPostError) as err:
  877. admin.add_composite_realm_roles_to_role(role_name=composite_role, roles=["bad"])
  878. assert err.match('500: b\'{"error":"unknown_error"}\'')
  879. res = admin.add_composite_realm_roles_to_role(
  880. role_name=composite_role, roles=[admin.get_realm_role(role_name="test-realm-role-update")]
  881. )
  882. assert res == dict(), res
  883. res = admin.get_composite_realm_roles_of_role(role_name=composite_role)
  884. assert len(res) == 1
  885. assert "test-realm-role-update" in res[0]["name"]
  886. with pytest.raises(KeycloakGetError) as err:
  887. admin.get_composite_realm_roles_of_role(role_name="bad")
  888. assert err.match('404: b\'{"error":"Could not find role"}\'')
  889. res = admin.get_composite_realm_roles_of_user(user_id=user_id)
  890. assert len(res) == 4
  891. assert "offline_access" in {x["name"] for x in res}
  892. assert "test-realm-role-update" in {x["name"] for x in res}
  893. assert "uma_authorization" in {x["name"] for x in res}
  894. with pytest.raises(KeycloakGetError) as err:
  895. admin.get_composite_realm_roles_of_user(user_id="bad")
  896. assert err.match('404: b\'{"error":"User not found"}\'')
  897. with pytest.raises(KeycloakDeleteError) as err:
  898. admin.remove_composite_realm_roles_to_role(role_name=composite_role, roles=["bad"])
  899. assert err.match('500: b\'{"error":"unknown_error"}\'')
  900. res = admin.remove_composite_realm_roles_to_role(
  901. role_name=composite_role, roles=[admin.get_realm_role(role_name="test-realm-role-update")]
  902. )
  903. assert res == dict(), res
  904. res = admin.get_composite_realm_roles_of_role(role_name=composite_role)
  905. assert len(res) == 0
  906. # Test delete realm role
  907. res = admin.delete_realm_role(role_name=composite_role)
  908. assert res == dict(), res
  909. with pytest.raises(KeycloakDeleteError) as err:
  910. admin.delete_realm_role(role_name=composite_role)
  911. assert err.match('404: b\'{"error":"Could not find role"}\'')
  912. @pytest.mark.parametrize(
  913. "testcase, arg_brief_repr, includes_attributes",
  914. [
  915. ("brief True", {"brief_representation": True}, False),
  916. ("brief False", {"brief_representation": False}, True),
  917. ("default", {}, False),
  918. ],
  919. )
  920. def test_role_attributes(
  921. admin: KeycloakAdmin,
  922. realm: str,
  923. client: str,
  924. arg_brief_repr: dict,
  925. includes_attributes: bool,
  926. testcase: str,
  927. ):
  928. """Test getting role attributes for bulk calls.
  929. :param admin: Keycloak admin
  930. :type admin: KeycloakAdmin
  931. :param realm: Keycloak realm
  932. :type realm: str
  933. :param client: Keycloak client
  934. :type client: str
  935. :param arg_brief_repr: Brief representation
  936. :type arg_brief_repr: dict
  937. :param includes_attributes: Indicator whether to include attributes
  938. :type includes_attributes: bool
  939. :param testcase: Test case
  940. :type testcase: str
  941. """
  942. # setup
  943. attribute_role = "test-realm-role-w-attr"
  944. test_attrs = {"attr1": ["val1"], "attr2": ["val2-1", "val2-2"]}
  945. role_id = admin.create_realm_role(
  946. payload={"name": attribute_role, "attributes": test_attrs}, skip_exists=True
  947. )
  948. assert role_id, role_id
  949. cli_role_id = admin.create_client_role(
  950. client, payload={"name": attribute_role, "attributes": test_attrs}, skip_exists=True
  951. )
  952. assert cli_role_id, cli_role_id
  953. if not includes_attributes:
  954. test_attrs = None
  955. # tests
  956. roles = admin.get_realm_roles(**arg_brief_repr)
  957. roles_filtered = [role for role in roles if role["name"] == role_id]
  958. assert roles_filtered, roles_filtered
  959. role = roles_filtered[0]
  960. assert role.get("attributes") == test_attrs, testcase
  961. roles = admin.get_client_roles(client, **arg_brief_repr)
  962. roles_filtered = [role for role in roles if role["name"] == cli_role_id]
  963. assert roles_filtered, roles_filtered
  964. role = roles_filtered[0]
  965. assert role.get("attributes") == test_attrs, testcase
  966. # cleanup
  967. res = admin.delete_realm_role(role_name=attribute_role)
  968. assert res == dict(), res
  969. res = admin.delete_client_role(client, role_name=attribute_role)
  970. assert res == dict(), res
  971. def test_client_scope_realm_roles(admin: KeycloakAdmin, realm: str):
  972. """Test client realm roles.
  973. :param admin: Keycloak admin
  974. :type admin: KeycloakAdmin
  975. :param realm: Keycloak realm
  976. :type realm: str
  977. """
  978. admin.realm_name = realm
  979. # Test get realm roles
  980. roles = admin.get_realm_roles()
  981. assert len(roles) == 3, roles
  982. role_names = [x["name"] for x in roles]
  983. assert "uma_authorization" in role_names, role_names
  984. assert "offline_access" in role_names, role_names
  985. # create realm role for test
  986. role_id = admin.create_realm_role(payload={"name": "test-realm-role"}, skip_exists=True)
  987. assert role_id, role_id
  988. # Test realm role client assignment
  989. client_id = admin.create_client(
  990. payload={"name": "role-testing-client", "clientId": "role-testing-client"}
  991. )
  992. with pytest.raises(KeycloakPostError) as err:
  993. admin.assign_realm_roles_to_client_scope(client_id=client_id, roles=["bad"])
  994. assert err.match('500: b\'{"error":"unknown_error"}\'')
  995. res = admin.assign_realm_roles_to_client_scope(
  996. client_id=client_id,
  997. roles=[
  998. admin.get_realm_role(role_name="offline_access"),
  999. admin.get_realm_role(role_name="test-realm-role"),
  1000. ],
  1001. )
  1002. assert res == dict(), res
  1003. roles = admin.get_realm_roles_of_client_scope(client_id=client_id)
  1004. assert len(roles) == 2
  1005. client_role_names = [x["name"] for x in roles]
  1006. assert "offline_access" in client_role_names, client_role_names
  1007. assert "test-realm-role" in client_role_names, client_role_names
  1008. assert "uma_authorization" not in client_role_names, client_role_names
  1009. # Test remove realm role of client
  1010. with pytest.raises(KeycloakDeleteError) as err:
  1011. admin.delete_realm_roles_of_client_scope(client_id=client_id, roles=["bad"])
  1012. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1013. res = admin.delete_realm_roles_of_client_scope(
  1014. client_id=client_id, roles=[admin.get_realm_role(role_name="offline_access")]
  1015. )
  1016. assert res == dict(), res
  1017. roles = admin.get_realm_roles_of_client_scope(client_id=client_id)
  1018. assert len(roles) == 1
  1019. assert "test-realm-role" in [x["name"] for x in roles]
  1020. res = admin.delete_realm_roles_of_client_scope(
  1021. client_id=client_id, roles=[admin.get_realm_role(role_name="test-realm-role")]
  1022. )
  1023. assert res == dict(), res
  1024. roles = admin.get_realm_roles_of_client_scope(client_id=client_id)
  1025. assert len(roles) == 0
  1026. def test_client_scope_client_roles(admin: KeycloakAdmin, realm: str, client: str):
  1027. """Test client assignment of other client roles.
  1028. :param admin: Keycloak admin
  1029. :type admin: KeycloakAdmin
  1030. :param realm: Keycloak realm
  1031. :type realm: str
  1032. :param client: Keycloak client
  1033. :type client: str
  1034. """
  1035. admin.realm_name = realm
  1036. client_id = admin.create_client(
  1037. payload={"name": "role-testing-client", "clientId": "role-testing-client"}
  1038. )
  1039. # Test get client roles
  1040. roles = admin.get_client_roles_of_client_scope(client_id, client)
  1041. assert len(roles) == 0, roles
  1042. # create client role for test
  1043. client_role_id = admin.create_client_role(
  1044. client_role_id=client, payload={"name": "client-role-test"}, skip_exists=True
  1045. )
  1046. assert client_role_id, client_role_id
  1047. # Test client role assignment to other client
  1048. with pytest.raises(KeycloakPostError) as err:
  1049. admin.assign_client_roles_to_client_scope(
  1050. client_id=client_id, client_roles_owner_id=client, roles=["bad"]
  1051. )
  1052. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1053. res = admin.assign_client_roles_to_client_scope(
  1054. client_id=client_id,
  1055. client_roles_owner_id=client,
  1056. roles=[admin.get_client_role(client_id=client, role_name="client-role-test")],
  1057. )
  1058. assert res == dict(), res
  1059. roles = admin.get_client_roles_of_client_scope(
  1060. client_id=client_id, client_roles_owner_id=client
  1061. )
  1062. assert len(roles) == 1
  1063. client_role_names = [x["name"] for x in roles]
  1064. assert "client-role-test" in client_role_names, client_role_names
  1065. # Test remove realm role of client
  1066. with pytest.raises(KeycloakDeleteError) as err:
  1067. admin.delete_client_roles_of_client_scope(
  1068. client_id=client_id, client_roles_owner_id=client, roles=["bad"]
  1069. )
  1070. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1071. res = admin.delete_client_roles_of_client_scope(
  1072. client_id=client_id,
  1073. client_roles_owner_id=client,
  1074. roles=[admin.get_client_role(client_id=client, role_name="client-role-test")],
  1075. )
  1076. assert res == dict(), res
  1077. roles = admin.get_client_roles_of_client_scope(
  1078. client_id=client_id, client_roles_owner_id=client
  1079. )
  1080. assert len(roles) == 0
  1081. def test_client_default_client_scopes(admin: KeycloakAdmin, realm: str, client: str):
  1082. """Test client assignment of default client scopes.
  1083. :param admin: Keycloak admin
  1084. :type admin: KeycloakAdmin
  1085. :param realm: Keycloak realm
  1086. :type realm: str
  1087. :param client: Keycloak client
  1088. :type client: str
  1089. """
  1090. admin.realm_name = realm
  1091. client_id = admin.create_client(
  1092. payload={"name": "role-testing-client", "clientId": "role-testing-client"}
  1093. )
  1094. # Test get client default scopes
  1095. # keycloak default roles: web-origins, acr, profile, roles, email
  1096. default_client_scopes = admin.get_client_default_client_scopes(client_id)
  1097. assert len(default_client_scopes) == 5, default_client_scopes
  1098. # Test add a client scope to client default scopes
  1099. default_client_scope = "test-client-default-scope"
  1100. new_client_scope = {
  1101. "name": default_client_scope,
  1102. "description": f"Test Client Scope: {default_client_scope}",
  1103. "protocol": "openid-connect",
  1104. "attributes": {},
  1105. }
  1106. new_client_scope_id = admin.create_client_scope(new_client_scope, skip_exists=False)
  1107. new_default_client_scope_data = {
  1108. "realm": realm,
  1109. "client": client_id,
  1110. "clientScopeId": new_client_scope_id,
  1111. }
  1112. admin.add_client_default_client_scope(
  1113. client_id, new_client_scope_id, new_default_client_scope_data
  1114. )
  1115. default_client_scopes = admin.get_client_default_client_scopes(client_id)
  1116. assert len(default_client_scopes) == 6, default_client_scopes
  1117. # Test remove a client default scope
  1118. admin.delete_client_default_client_scope(client_id, new_client_scope_id)
  1119. default_client_scopes = admin.get_client_default_client_scopes(client_id)
  1120. assert len(default_client_scopes) == 5, default_client_scopes
  1121. def test_client_optional_client_scopes(admin: KeycloakAdmin, realm: str, client: str):
  1122. """Test client assignment of optional client scopes.
  1123. :param admin: Keycloak admin
  1124. :type admin: KeycloakAdmin
  1125. :param realm: Keycloak realm
  1126. :type realm: str
  1127. :param client: Keycloak client
  1128. :type client: str
  1129. """
  1130. admin.realm_name = realm
  1131. client_id = admin.create_client(
  1132. payload={"name": "role-testing-client", "clientId": "role-testing-client"}
  1133. )
  1134. # Test get client optional scopes
  1135. # keycloak optional roles: microprofile-jwt, offline_access, address, phone
  1136. optional_client_scopes = admin.get_client_optional_client_scopes(client_id)
  1137. assert len(optional_client_scopes) == 4, optional_client_scopes
  1138. # Test add a client scope to client optional scopes
  1139. optional_client_scope = "test-client-optional-scope"
  1140. new_client_scope = {
  1141. "name": optional_client_scope,
  1142. "description": f"Test Client Scope: {optional_client_scope}",
  1143. "protocol": "openid-connect",
  1144. "attributes": {},
  1145. }
  1146. new_client_scope_id = admin.create_client_scope(new_client_scope, skip_exists=False)
  1147. new_optional_client_scope_data = {
  1148. "realm": realm,
  1149. "client": client_id,
  1150. "clientScopeId": new_client_scope_id,
  1151. }
  1152. admin.add_client_optional_client_scope(
  1153. client_id, new_client_scope_id, new_optional_client_scope_data
  1154. )
  1155. optional_client_scopes = admin.get_client_optional_client_scopes(client_id)
  1156. assert len(optional_client_scopes) == 5, optional_client_scopes
  1157. # Test remove a client optional scope
  1158. admin.delete_client_optional_client_scope(client_id, new_client_scope_id)
  1159. optional_client_scopes = admin.get_client_optional_client_scopes(client_id)
  1160. assert len(optional_client_scopes) == 4, optional_client_scopes
  1161. def test_client_roles(admin: KeycloakAdmin, client: str):
  1162. """Test client roles.
  1163. :param admin: Keycloak Admin client
  1164. :type admin: KeycloakAdmin
  1165. :param client: Keycloak client
  1166. :type client: str
  1167. """
  1168. # Test get client roles
  1169. res = admin.get_client_roles(client_id=client)
  1170. assert len(res) == 0
  1171. with pytest.raises(KeycloakGetError) as err:
  1172. admin.get_client_roles(client_id="bad")
  1173. assert err.match('404: b\'{"error":"Could not find client"}\'')
  1174. # Test create client role
  1175. client_role_id = admin.create_client_role(
  1176. client_role_id=client, payload={"name": "client-role-test"}, skip_exists=True
  1177. )
  1178. with pytest.raises(KeycloakPostError) as err:
  1179. admin.create_client_role(client_role_id=client, payload={"name": "client-role-test"})
  1180. assert err.match('409: b\'{"errorMessage":"Role with name client-role-test already exists"}\'')
  1181. client_role_id_2 = admin.create_client_role(
  1182. client_role_id=client, payload={"name": "client-role-test"}, skip_exists=True
  1183. )
  1184. assert client_role_id == client_role_id_2
  1185. # Test get client role
  1186. res = admin.get_client_role(client_id=client, role_name="client-role-test")
  1187. assert res["name"] == client_role_id
  1188. with pytest.raises(KeycloakGetError) as err:
  1189. admin.get_client_role(client_id=client, role_name="bad")
  1190. assert err.match('404: b\'{"error":"Could not find role"}\'')
  1191. res_ = admin.get_client_role_id(client_id=client, role_name="client-role-test")
  1192. assert res_ == res["id"]
  1193. with pytest.raises(KeycloakGetError) as err:
  1194. admin.get_client_role_id(client_id=client, role_name="bad")
  1195. assert err.match('404: b\'{"error":"Could not find role"}\'')
  1196. assert len(admin.get_client_roles(client_id=client)) == 1
  1197. # Test update client role
  1198. res = admin.update_client_role(
  1199. client_role_id=client,
  1200. role_name="client-role-test",
  1201. payload={"name": "client-role-test-update"},
  1202. )
  1203. assert res == dict()
  1204. with pytest.raises(KeycloakPutError) as err:
  1205. res = admin.update_client_role(
  1206. client_role_id=client,
  1207. role_name="client-role-test",
  1208. payload={"name": "client-role-test-update"},
  1209. )
  1210. assert err.match('404: b\'{"error":"Could not find role"}\'')
  1211. # Test user with client role
  1212. res = admin.get_client_role_members(client_id=client, role_name="client-role-test-update")
  1213. assert len(res) == 0
  1214. with pytest.raises(KeycloakGetError) as err:
  1215. admin.get_client_role_members(client_id=client, role_name="bad")
  1216. assert err.match('404: b\'{"error":"Could not find role"}\'')
  1217. user_id = admin.create_user(payload={"username": "test", "email": "test@test.test"})
  1218. with pytest.raises(KeycloakPostError) as err:
  1219. admin.assign_client_role(user_id=user_id, client_id=client, roles=["bad"])
  1220. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1221. res = admin.assign_client_role(
  1222. user_id=user_id,
  1223. client_id=client,
  1224. roles=[admin.get_client_role(client_id=client, role_name="client-role-test-update")],
  1225. )
  1226. assert res == dict()
  1227. assert (
  1228. len(admin.get_client_role_members(client_id=client, role_name="client-role-test-update"))
  1229. == 1
  1230. )
  1231. roles = admin.get_client_roles_of_user(user_id=user_id, client_id=client)
  1232. assert len(roles) == 1, roles
  1233. with pytest.raises(KeycloakGetError) as err:
  1234. admin.get_client_roles_of_user(user_id=user_id, client_id="bad")
  1235. assert err.match('404: b\'{"error":"Client not found"}\'')
  1236. roles = admin.get_composite_client_roles_of_user(user_id=user_id, client_id=client)
  1237. assert len(roles) == 1, roles
  1238. with pytest.raises(KeycloakGetError) as err:
  1239. admin.get_composite_client_roles_of_user(user_id=user_id, client_id="bad")
  1240. assert err.match('404: b\'{"error":"Client not found"}\'')
  1241. roles = admin.get_available_client_roles_of_user(user_id=user_id, client_id=client)
  1242. assert len(roles) == 0, roles
  1243. with pytest.raises(KeycloakGetError) as err:
  1244. admin.get_composite_client_roles_of_user(user_id=user_id, client_id="bad")
  1245. assert err.match('404: b\'{"error":"Client not found"}\'')
  1246. with pytest.raises(KeycloakDeleteError) as err:
  1247. admin.delete_client_roles_of_user(user_id=user_id, client_id=client, roles=["bad"])
  1248. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1249. admin.delete_client_roles_of_user(
  1250. user_id=user_id,
  1251. client_id=client,
  1252. roles=[admin.get_client_role(client_id=client, role_name="client-role-test-update")],
  1253. )
  1254. assert len(admin.get_client_roles_of_user(user_id=user_id, client_id=client)) == 0
  1255. # Test groups and client roles
  1256. res = admin.get_client_role_groups(client_id=client, role_name="client-role-test-update")
  1257. assert len(res) == 0
  1258. with pytest.raises(KeycloakGetError) as err:
  1259. admin.get_client_role_groups(client_id=client, role_name="bad")
  1260. assert err.match('404: b\'{"error":"Could not find role"}\'')
  1261. group_id = admin.create_group(payload={"name": "test-group"})
  1262. res = admin.get_group_client_roles(group_id=group_id, client_id=client)
  1263. assert len(res) == 0
  1264. with pytest.raises(KeycloakGetError) as err:
  1265. admin.get_group_client_roles(group_id=group_id, client_id="bad")
  1266. assert err.match('404: b\'{"error":"Client not found"}\'')
  1267. with pytest.raises(KeycloakPostError) as err:
  1268. admin.assign_group_client_roles(group_id=group_id, client_id=client, roles=["bad"])
  1269. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1270. res = admin.assign_group_client_roles(
  1271. group_id=group_id,
  1272. client_id=client,
  1273. roles=[admin.get_client_role(client_id=client, role_name="client-role-test-update")],
  1274. )
  1275. assert res == dict()
  1276. assert (
  1277. len(admin.get_client_role_groups(client_id=client, role_name="client-role-test-update"))
  1278. == 1
  1279. )
  1280. assert len(admin.get_group_client_roles(group_id=group_id, client_id=client)) == 1
  1281. with pytest.raises(KeycloakDeleteError) as err:
  1282. admin.delete_group_client_roles(group_id=group_id, client_id=client, roles=["bad"])
  1283. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1284. res = admin.delete_group_client_roles(
  1285. group_id=group_id,
  1286. client_id=client,
  1287. roles=[admin.get_client_role(client_id=client, role_name="client-role-test-update")],
  1288. )
  1289. assert res == dict()
  1290. # Test composite client roles
  1291. with pytest.raises(KeycloakPostError) as err:
  1292. admin.add_composite_client_roles_to_role(
  1293. client_role_id=client, role_name="client-role-test-update", roles=["bad"]
  1294. )
  1295. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1296. res = admin.add_composite_client_roles_to_role(
  1297. client_role_id=client,
  1298. role_name="client-role-test-update",
  1299. roles=[admin.get_realm_role(role_name="offline_access")],
  1300. )
  1301. assert res == dict()
  1302. assert admin.get_client_role(client_id=client, role_name="client-role-test-update")[
  1303. "composite"
  1304. ]
  1305. # Test delete of client role
  1306. res = admin.delete_client_role(client_role_id=client, role_name="client-role-test-update")
  1307. assert res == dict()
  1308. with pytest.raises(KeycloakDeleteError) as err:
  1309. admin.delete_client_role(client_role_id=client, role_name="client-role-test-update")
  1310. assert err.match('404: b\'{"error":"Could not find role"}\'')
  1311. def test_enable_token_exchange(admin: KeycloakAdmin, realm: str):
  1312. """Test enable token exchange.
  1313. :param admin: Keycloak Admin client
  1314. :type admin: KeycloakAdmin
  1315. :param realm: Keycloak realm
  1316. :type realm: str
  1317. :raises AssertionError: In case of bad configuration
  1318. """
  1319. # Test enabling token exchange between two confidential clients
  1320. admin.realm_name = realm
  1321. # Create test clients
  1322. source_client_id = admin.create_client(
  1323. payload={"name": "Source Client", "clientId": "source-client"}
  1324. )
  1325. target_client_id = admin.create_client(
  1326. payload={"name": "Target Client", "clientId": "target-client"}
  1327. )
  1328. for c in admin.get_clients():
  1329. if c["clientId"] == "realm-management":
  1330. realm_management_id = c["id"]
  1331. break
  1332. else:
  1333. raise AssertionError("Missing realm management client")
  1334. # Enable permissions on the Superset client
  1335. admin.update_client_management_permissions(
  1336. payload={"enabled": True}, client_id=target_client_id
  1337. )
  1338. # Fetch various IDs and strings needed when creating the permission
  1339. token_exchange_permission_id = admin.get_client_management_permissions(
  1340. client_id=target_client_id
  1341. )["scopePermissions"]["token-exchange"]
  1342. scopes = admin.get_client_authz_policy_scopes(
  1343. client_id=realm_management_id, policy_id=token_exchange_permission_id
  1344. )
  1345. for s in scopes:
  1346. if s["name"] == "token-exchange":
  1347. token_exchange_scope_id = s["id"]
  1348. break
  1349. else:
  1350. raise AssertionError("Missing token-exchange scope")
  1351. resources = admin.get_client_authz_policy_resources(
  1352. client_id=realm_management_id, policy_id=token_exchange_permission_id
  1353. )
  1354. for r in resources:
  1355. if r["name"] == f"client.resource.{target_client_id}":
  1356. token_exchange_resource_id = r["_id"]
  1357. break
  1358. else:
  1359. raise AssertionError("Missing client resource")
  1360. # Create a client policy for source client
  1361. policy_name = "Exchange source client token with target client token"
  1362. client_policy_id = admin.create_client_authz_client_policy(
  1363. payload={
  1364. "type": "client",
  1365. "logic": "POSITIVE",
  1366. "decisionStrategy": "UNANIMOUS",
  1367. "name": policy_name,
  1368. "clients": [source_client_id],
  1369. },
  1370. client_id=realm_management_id,
  1371. )["id"]
  1372. policies = admin.get_client_authz_client_policies(client_id=realm_management_id)
  1373. for policy in policies:
  1374. if policy["name"] == policy_name:
  1375. assert policy["clients"] == [source_client_id]
  1376. break
  1377. else:
  1378. raise AssertionError("Missing client policy")
  1379. # Update permissions on the target client to reference this policy
  1380. permission_name = admin.get_client_authz_scope_permission(
  1381. client_id=realm_management_id, scope_id=token_exchange_permission_id
  1382. )["name"]
  1383. admin.update_client_authz_scope_permission(
  1384. payload={
  1385. "id": token_exchange_permission_id,
  1386. "name": permission_name,
  1387. "type": "scope",
  1388. "logic": "POSITIVE",
  1389. "decisionStrategy": "UNANIMOUS",
  1390. "resources": [token_exchange_resource_id],
  1391. "scopes": [token_exchange_scope_id],
  1392. "policies": [client_policy_id],
  1393. },
  1394. client_id=realm_management_id,
  1395. scope_id=token_exchange_permission_id,
  1396. )
  1397. def test_email(admin: KeycloakAdmin, user: str):
  1398. """Test email.
  1399. :param admin: Keycloak Admin client
  1400. :type admin: KeycloakAdmin
  1401. :param user: Keycloak user
  1402. :type user: str
  1403. """
  1404. # Emails will fail as we don't have SMTP test setup
  1405. with pytest.raises(KeycloakPutError) as err:
  1406. admin.send_update_account(user_id=user, payload=dict())
  1407. assert err.match('500: b\'{"error":"unknown_error"}\'')
  1408. admin.update_user(user_id=user, payload={"enabled": True})
  1409. with pytest.raises(KeycloakPutError) as err:
  1410. admin.send_verify_email(user_id=user)
  1411. assert err.match('500: b\'{"errorMessage":"Failed to send execute actions email"}\'')
  1412. def test_get_sessions(admin: KeycloakAdmin):
  1413. """Test get sessions.
  1414. :param admin: Keycloak Admin client
  1415. :type admin: KeycloakAdmin
  1416. """
  1417. sessions = admin.get_sessions(user_id=admin.get_user_id(username=admin.username))
  1418. assert len(sessions) >= 1
  1419. with pytest.raises(KeycloakGetError) as err:
  1420. admin.get_sessions(user_id="bad")
  1421. assert err.match('404: b\'{"error":"User not found"}\'')
  1422. def test_get_client_installation_provider(admin: KeycloakAdmin, client: str):
  1423. """Test get client installation provider.
  1424. :param admin: Keycloak Admin client
  1425. :type admin: KeycloakAdmin
  1426. :param client: Keycloak client
  1427. :type client: str
  1428. """
  1429. with pytest.raises(KeycloakGetError) as err:
  1430. admin.get_client_installation_provider(client_id=client, provider_id="bad")
  1431. assert err.match('404: b\'{"error":"Unknown Provider"}\'')
  1432. installation = admin.get_client_installation_provider(
  1433. client_id=client, provider_id="keycloak-oidc-keycloak-json"
  1434. )
  1435. assert set(installation.keys()) == {
  1436. "auth-server-url",
  1437. "confidential-port",
  1438. "credentials",
  1439. "realm",
  1440. "resource",
  1441. "ssl-required",
  1442. }
  1443. def test_auth_flows(admin: KeycloakAdmin, realm: str):
  1444. """Test auth flows.
  1445. :param admin: Keycloak Admin client
  1446. :type admin: KeycloakAdmin
  1447. :param realm: Keycloak realm
  1448. :type realm: str
  1449. """
  1450. admin.realm_name = realm
  1451. res = admin.get_authentication_flows()
  1452. assert len(res) == 8, res
  1453. assert set(res[0].keys()) == {
  1454. "alias",
  1455. "authenticationExecutions",
  1456. "builtIn",
  1457. "description",
  1458. "id",
  1459. "providerId",
  1460. "topLevel",
  1461. }
  1462. assert {x["alias"] for x in res} == {
  1463. "reset credentials",
  1464. "browser",
  1465. "http challenge",
  1466. "registration",
  1467. "docker auth",
  1468. "direct grant",
  1469. "first broker login",
  1470. "clients",
  1471. }
  1472. with pytest.raises(KeycloakGetError) as err:
  1473. admin.get_authentication_flow_for_id(flow_id="bad")
  1474. assert err.match('404: b\'{"error":"Could not find flow with id"}\'')
  1475. browser_flow_id = [x for x in res if x["alias"] == "browser"][0]["id"]
  1476. res = admin.get_authentication_flow_for_id(flow_id=browser_flow_id)
  1477. assert res["alias"] == "browser"
  1478. # Test copying
  1479. with pytest.raises(KeycloakPostError) as err:
  1480. admin.copy_authentication_flow(payload=dict(), flow_alias="bad")
  1481. assert err.match("404: b''")
  1482. res = admin.copy_authentication_flow(payload={"newName": "test-browser"}, flow_alias="browser")
  1483. assert res == b"", res
  1484. assert len(admin.get_authentication_flows()) == 9
  1485. # Test create
  1486. res = admin.create_authentication_flow(
  1487. payload={"alias": "test-create", "providerId": "basic-flow"}
  1488. )
  1489. assert res == b""
  1490. with pytest.raises(KeycloakPostError) as err:
  1491. admin.create_authentication_flow(payload={"alias": "test-create", "builtIn": False})
  1492. assert err.match('409: b\'{"errorMessage":"Flow test-create already exists"}\'')
  1493. assert admin.create_authentication_flow(
  1494. payload={"alias": "test-create"}, skip_exists=True
  1495. ) == {"msg": "Already exists"}
  1496. # Test flow executions
  1497. res = admin.get_authentication_flow_executions(flow_alias="browser")
  1498. assert len(res) == 8, res
  1499. with pytest.raises(KeycloakGetError) as err:
  1500. admin.get_authentication_flow_executions(flow_alias="bad")
  1501. assert err.match("404: b''")
  1502. exec_id = res[0]["id"]
  1503. res = admin.get_authentication_flow_execution(execution_id=exec_id)
  1504. assert set(res.keys()) == {
  1505. "alternative",
  1506. "authenticator",
  1507. "authenticatorFlow",
  1508. "conditional",
  1509. "disabled",
  1510. "enabled",
  1511. "id",
  1512. "parentFlow",
  1513. "priority",
  1514. "required",
  1515. "requirement",
  1516. }, res
  1517. with pytest.raises(KeycloakGetError) as err:
  1518. admin.get_authentication_flow_execution(execution_id="bad")
  1519. assert err.match('404: b\'{"error":"Illegal execution"}\'')
  1520. with pytest.raises(KeycloakPostError) as err:
  1521. admin.create_authentication_flow_execution(payload=dict(), flow_alias="browser")
  1522. assert err.match('400: b\'{"error":"It is illegal to add execution to a built in flow"}\'')
  1523. res = admin.create_authentication_flow_execution(
  1524. payload={"provider": "auth-cookie"}, flow_alias="test-create"
  1525. )
  1526. assert res == b""
  1527. assert len(admin.get_authentication_flow_executions(flow_alias="test-create")) == 1
  1528. with pytest.raises(KeycloakPutError) as err:
  1529. admin.update_authentication_flow_executions(
  1530. payload={"required": "yes"}, flow_alias="test-create"
  1531. )
  1532. assert err.match('400: b\'{"error":"Unrecognized field')
  1533. payload = admin.get_authentication_flow_executions(flow_alias="test-create")[0]
  1534. payload["displayName"] = "test"
  1535. res = admin.update_authentication_flow_executions(payload=payload, flow_alias="test-create")
  1536. assert res
  1537. exec_id = admin.get_authentication_flow_executions(flow_alias="test-create")[0]["id"]
  1538. res = admin.delete_authentication_flow_execution(execution_id=exec_id)
  1539. assert res == dict()
  1540. with pytest.raises(KeycloakDeleteError) as err:
  1541. admin.delete_authentication_flow_execution(execution_id=exec_id)
  1542. assert err.match('404: b\'{"error":"Illegal execution"}\'')
  1543. # Test subflows
  1544. res = admin.create_authentication_flow_subflow(
  1545. payload={
  1546. "alias": "test-subflow",
  1547. "provider": "basic-flow",
  1548. "type": "something",
  1549. "description": "something",
  1550. },
  1551. flow_alias="test-browser",
  1552. )
  1553. assert res == b""
  1554. with pytest.raises(KeycloakPostError) as err:
  1555. admin.create_authentication_flow_subflow(
  1556. payload={"alias": "test-subflow", "providerId": "basic-flow"},
  1557. flow_alias="test-browser",
  1558. )
  1559. assert err.match('409: b\'{"errorMessage":"New flow alias name already exists"}\'')
  1560. res = admin.create_authentication_flow_subflow(
  1561. payload={
  1562. "alias": "test-subflow",
  1563. "provider": "basic-flow",
  1564. "type": "something",
  1565. "description": "something",
  1566. },
  1567. flow_alias="test-create",
  1568. skip_exists=True,
  1569. )
  1570. assert res == {"msg": "Already exists"}
  1571. # Test delete auth flow
  1572. flow_id = [x for x in admin.get_authentication_flows() if x["alias"] == "test-browser"][0][
  1573. "id"
  1574. ]
  1575. res = admin.delete_authentication_flow(flow_id=flow_id)
  1576. assert res == dict()
  1577. with pytest.raises(KeycloakDeleteError) as err:
  1578. admin.delete_authentication_flow(flow_id=flow_id)
  1579. assert err.match('404: b\'{"error":"Could not find flow with id"}\'')
  1580. def test_authentication_configs(admin: KeycloakAdmin, realm: str):
  1581. """Test authentication configs.
  1582. :param admin: Keycloak Admin client
  1583. :type admin: KeycloakAdmin
  1584. :param realm: Keycloak realm
  1585. :type realm: str
  1586. """
  1587. admin.realm_name = realm
  1588. # Test list of auth providers
  1589. res = admin.get_authenticator_providers()
  1590. assert len(res) == 38
  1591. res = admin.get_authenticator_provider_config_description(provider_id="auth-cookie")
  1592. assert res == {
  1593. "helpText": "Validates the SSO cookie set by the auth server.",
  1594. "name": "Cookie",
  1595. "properties": [],
  1596. "providerId": "auth-cookie",
  1597. }
  1598. # Test authenticator config
  1599. # Currently unable to find a sustainable way to fetch the config id,
  1600. # therefore testing only failures
  1601. with pytest.raises(KeycloakGetError) as err:
  1602. admin.get_authenticator_config(config_id="bad")
  1603. assert err.match('404: b\'{"error":"Could not find authenticator config"}\'')
  1604. with pytest.raises(KeycloakPutError) as err:
  1605. admin.update_authenticator_config(payload=dict(), config_id="bad")
  1606. assert err.match('404: b\'{"error":"Could not find authenticator config"}\'')
  1607. with pytest.raises(KeycloakDeleteError) as err:
  1608. admin.delete_authenticator_config(config_id="bad")
  1609. assert err.match('404: b\'{"error":"Could not find authenticator config"}\'')
  1610. def test_sync_users(admin: KeycloakAdmin, realm: str):
  1611. """Test sync users.
  1612. :param admin: Keycloak Admin client
  1613. :type admin: KeycloakAdmin
  1614. :param realm: Keycloak realm
  1615. :type realm: str
  1616. """
  1617. admin.realm_name = realm
  1618. # Only testing the error message
  1619. with pytest.raises(KeycloakPostError) as err:
  1620. admin.sync_users(storage_id="does-not-exist", action="triggerFullSync")
  1621. assert err.match('404: b\'{"error":"Could not find component"}\'')
  1622. def test_client_scopes(admin: KeycloakAdmin, realm: str):
  1623. """Test client scopes.
  1624. :param admin: Keycloak Admin client
  1625. :type admin: KeycloakAdmin
  1626. :param realm: Keycloak realm
  1627. :type realm: str
  1628. """
  1629. admin.realm_name = realm
  1630. # Test get client scopes
  1631. res = admin.get_client_scopes()
  1632. scope_names = {x["name"] for x in res}
  1633. assert len(res) == 10
  1634. assert "email" in scope_names
  1635. assert "profile" in scope_names
  1636. assert "offline_access" in scope_names
  1637. with pytest.raises(KeycloakGetError) as err:
  1638. admin.get_client_scope(client_scope_id="does-not-exist")
  1639. assert err.match('404: b\'{"error":"Could not find client scope"}\'')
  1640. scope = admin.get_client_scope(client_scope_id=res[0]["id"])
  1641. assert res[0] == scope
  1642. scope = admin.get_client_scope_by_name(client_scope_name=res[0]["name"])
  1643. assert res[0] == scope
  1644. # Test create client scope
  1645. res = admin.create_client_scope(payload={"name": "test-scope"}, skip_exists=True)
  1646. assert res
  1647. res2 = admin.create_client_scope(payload={"name": "test-scope"}, skip_exists=True)
  1648. assert res == res2
  1649. with pytest.raises(KeycloakPostError) as err:
  1650. admin.create_client_scope(payload={"name": "test-scope"}, skip_exists=False)
  1651. assert err.match('409: b\'{"errorMessage":"Client Scope test-scope already exists"}\'')
  1652. # Test update client scope
  1653. with pytest.raises(KeycloakPutError) as err:
  1654. admin.update_client_scope(client_scope_id="does-not-exist", payload=dict())
  1655. assert err.match('404: b\'{"error":"Could not find client scope"}\'')
  1656. res_update = admin.update_client_scope(
  1657. client_scope_id=res, payload={"name": "test-scope-update"}
  1658. )
  1659. assert res_update == dict()
  1660. admin.get_client_scope(client_scope_id=res)["name"] == "test-scope-update"
  1661. # Test get mappers
  1662. mappers = admin.get_mappers_from_client_scope(client_scope_id=res)
  1663. assert mappers == list()
  1664. # Test add mapper
  1665. with pytest.raises(KeycloakPostError) as err:
  1666. admin.add_mapper_to_client_scope(client_scope_id=res, payload=dict())
  1667. assert err.match('404: b\'{"error":"ProtocolMapper provider not found"}\'')
  1668. res_add = admin.add_mapper_to_client_scope(
  1669. client_scope_id=res,
  1670. payload={
  1671. "name": "test-mapper",
  1672. "protocol": "openid-connect",
  1673. "protocolMapper": "oidc-usermodel-attribute-mapper",
  1674. },
  1675. )
  1676. assert res_add == b""
  1677. assert len(admin.get_mappers_from_client_scope(client_scope_id=res)) == 1
  1678. # Test update mapper
  1679. test_mapper = admin.get_mappers_from_client_scope(client_scope_id=res)[0]
  1680. with pytest.raises(KeycloakPutError) as err:
  1681. admin.update_mapper_in_client_scope(
  1682. client_scope_id="does-not-exist", protocol_mapper_id=test_mapper["id"], payload=dict()
  1683. )
  1684. assert err.match('404: b\'{"error":"Could not find client scope"}\'')
  1685. test_mapper["config"]["user.attribute"] = "test"
  1686. res_update = admin.update_mapper_in_client_scope(
  1687. client_scope_id=res, protocol_mapper_id=test_mapper["id"], payload=test_mapper
  1688. )
  1689. assert res_update == dict()
  1690. assert (
  1691. admin.get_mappers_from_client_scope(client_scope_id=res)[0]["config"]["user.attribute"]
  1692. == "test"
  1693. )
  1694. # Test delete mapper
  1695. res_del = admin.delete_mapper_from_client_scope(
  1696. client_scope_id=res, protocol_mapper_id=test_mapper["id"]
  1697. )
  1698. assert res_del == dict()
  1699. with pytest.raises(KeycloakDeleteError) as err:
  1700. admin.delete_mapper_from_client_scope(
  1701. client_scope_id=res, protocol_mapper_id=test_mapper["id"]
  1702. )
  1703. assert err.match('404: b\'{"error":"Model not found"}\'')
  1704. # Test default default scopes
  1705. res_defaults = admin.get_default_default_client_scopes()
  1706. assert len(res_defaults) == 6
  1707. with pytest.raises(KeycloakPutError) as err:
  1708. admin.add_default_default_client_scope(scope_id="does-not-exist")
  1709. assert err.match('404: b\'{"error":"Client scope not found"}\'')
  1710. res_add = admin.add_default_default_client_scope(scope_id=res)
  1711. assert res_add == dict()
  1712. assert len(admin.get_default_default_client_scopes()) == 7
  1713. with pytest.raises(KeycloakDeleteError) as err:
  1714. admin.delete_default_default_client_scope(scope_id="does-not-exist")
  1715. assert err.match('404: b\'{"error":"Client scope not found"}\'')
  1716. res_del = admin.delete_default_default_client_scope(scope_id=res)
  1717. assert res_del == dict()
  1718. assert len(admin.get_default_default_client_scopes()) == 6
  1719. # Test default optional scopes
  1720. res_defaults = admin.get_default_optional_client_scopes()
  1721. assert len(res_defaults) == 4
  1722. with pytest.raises(KeycloakPutError) as err:
  1723. admin.add_default_optional_client_scope(scope_id="does-not-exist")
  1724. assert err.match('404: b\'{"error":"Client scope not found"}\'')
  1725. res_add = admin.add_default_optional_client_scope(scope_id=res)
  1726. assert res_add == dict()
  1727. assert len(admin.get_default_optional_client_scopes()) == 5
  1728. with pytest.raises(KeycloakDeleteError) as err:
  1729. admin.delete_default_optional_client_scope(scope_id="does-not-exist")
  1730. assert err.match('404: b\'{"error":"Client scope not found"}\'')
  1731. res_del = admin.delete_default_optional_client_scope(scope_id=res)
  1732. assert res_del == dict()
  1733. assert len(admin.get_default_optional_client_scopes()) == 4
  1734. # Test client scope delete
  1735. res_del = admin.delete_client_scope(client_scope_id=res)
  1736. assert res_del == dict()
  1737. with pytest.raises(KeycloakDeleteError) as err:
  1738. admin.delete_client_scope(client_scope_id=res)
  1739. assert err.match('404: b\'{"error":"Could not find client scope"}\'')
  1740. def test_components(admin: KeycloakAdmin, realm: str):
  1741. """Test components.
  1742. :param admin: Keycloak Admin client
  1743. :type admin: KeycloakAdmin
  1744. :param realm: Keycloak realm
  1745. :type realm: str
  1746. """
  1747. admin.realm_name = realm
  1748. # Test get components
  1749. res = admin.get_components()
  1750. assert len(res) == 12
  1751. with pytest.raises(KeycloakGetError) as err:
  1752. admin.get_component(component_id="does-not-exist")
  1753. assert err.match('404: b\'{"error":"Could not find component"}\'')
  1754. res_get = admin.get_component(component_id=res[0]["id"])
  1755. assert res_get == res[0]
  1756. # Test create component
  1757. with pytest.raises(KeycloakPostError) as err:
  1758. admin.create_component(payload={"bad": "dict"})
  1759. assert err.match('400: b\'{"error":"Unrecognized field')
  1760. res = admin.create_component(
  1761. payload={
  1762. "name": "Test Component",
  1763. "providerId": "max-clients",
  1764. "providerType": "org.keycloak.services.clientregistration."
  1765. + "policy.ClientRegistrationPolicy",
  1766. "config": {"max-clients": ["1000"]},
  1767. }
  1768. )
  1769. assert res
  1770. assert admin.get_component(component_id=res)["name"] == "Test Component"
  1771. # Test update component
  1772. component = admin.get_component(component_id=res)
  1773. component["name"] = "Test Component Update"
  1774. with pytest.raises(KeycloakPutError) as err:
  1775. admin.update_component(component_id="does-not-exist", payload=dict())
  1776. assert err.match('404: b\'{"error":"Could not find component"}\'')
  1777. res_upd = admin.update_component(component_id=res, payload=component)
  1778. assert res_upd == dict()
  1779. assert admin.get_component(component_id=res)["name"] == "Test Component Update"
  1780. # Test delete component
  1781. res_del = admin.delete_component(component_id=res)
  1782. assert res_del == dict()
  1783. with pytest.raises(KeycloakDeleteError) as err:
  1784. admin.delete_component(component_id=res)
  1785. assert err.match('404: b\'{"error":"Could not find component"}\'')
  1786. def test_keys(admin: KeycloakAdmin, realm: str):
  1787. """Test keys.
  1788. :param admin: Keycloak Admin client
  1789. :type admin: KeycloakAdmin
  1790. :param realm: Keycloak realm
  1791. :type realm: str
  1792. """
  1793. admin.realm_name = realm
  1794. assert set(admin.get_keys()["active"].keys()) == {"AES", "HS256", "RS256", "RSA-OAEP"}
  1795. assert {k["algorithm"] for k in admin.get_keys()["keys"]} == {
  1796. "HS256",
  1797. "RSA-OAEP",
  1798. "AES",
  1799. "RS256",
  1800. }
  1801. def test_events(admin: KeycloakAdmin, realm: str):
  1802. """Test events.
  1803. :param admin: Keycloak Admin client
  1804. :type admin: KeycloakAdmin
  1805. :param realm: Keycloak realm
  1806. :type realm: str
  1807. """
  1808. admin.realm_name = realm
  1809. events = admin.get_events()
  1810. assert events == list()
  1811. with pytest.raises(KeycloakPutError) as err:
  1812. admin.set_events(payload={"bad": "conf"})
  1813. assert err.match('400: b\'{"error":"Unrecognized field')
  1814. res = admin.set_events(payload={"adminEventsDetailsEnabled": True, "adminEventsEnabled": True})
  1815. assert res == dict()
  1816. admin.create_client(payload={"name": "test", "clientId": "test"})
  1817. events = admin.get_events()
  1818. assert events == list()
  1819. @freezegun.freeze_time("2023-02-25 10:00:00")
  1820. def test_auto_refresh(admin_frozen: KeycloakAdmin, realm: str):
  1821. """Test auto refresh token.
  1822. :param admin_frozen: Keycloak Admin client with time frozen in place
  1823. :type admin_frozen: KeycloakAdmin
  1824. :param realm: Keycloak realm
  1825. :type realm: str
  1826. """
  1827. admin = admin_frozen
  1828. # Test get refresh
  1829. admin.connection.custom_headers = {
  1830. "Authorization": "Bearer bad",
  1831. "Content-Type": "application/json",
  1832. }
  1833. with pytest.raises(KeycloakAuthenticationError) as err:
  1834. admin.get_realm(realm_name=realm)
  1835. assert err.match('401: b\'{"error":"HTTP 401 Unauthorized"}\'')
  1836. # Freeze time to simulate the access token expiring
  1837. with freezegun.freeze_time("2023-02-25 10:05:00"):
  1838. assert admin.connection.expires_at < datetime_parser.parse("2023-02-25 10:05:00")
  1839. assert admin.get_realm(realm_name=realm)
  1840. assert admin.connection.expires_at > datetime_parser.parse("2023-02-25 10:05:00")
  1841. # Test bad refresh token, but first make sure access token has expired again
  1842. with freezegun.freeze_time("2023-02-25 10:10:00"):
  1843. admin.connection.custom_headers = {"Content-Type": "application/json"}
  1844. admin.connection.token["refresh_token"] = "bad"
  1845. with pytest.raises(KeycloakPostError) as err:
  1846. admin.get_realm(realm_name="test-refresh")
  1847. assert err.match(
  1848. '400: b\'{"error":"invalid_grant","error_description":"Invalid refresh token"}\''
  1849. )
  1850. admin.connection.get_token()
  1851. # Test post refresh
  1852. with freezegun.freeze_time("2023-02-25 10:15:00"):
  1853. assert admin.connection.expires_at < datetime_parser.parse("2023-02-25 10:15:00")
  1854. admin.connection.token = None
  1855. assert admin.create_realm(payload={"realm": "test-refresh"}) == b""
  1856. assert admin.connection.expires_at > datetime_parser.parse("2023-02-25 10:15:00")
  1857. # Test update refresh
  1858. with freezegun.freeze_time("2023-02-25 10:25:00"):
  1859. assert admin.connection.expires_at < datetime_parser.parse("2023-02-25 10:25:00")
  1860. admin.connection.token = None
  1861. assert (
  1862. admin.update_realm(realm_name="test-refresh", payload={"accountTheme": "test"})
  1863. == dict()
  1864. )
  1865. assert admin.connection.expires_at > datetime_parser.parse("2023-02-25 10:25:00")
  1866. # Test delete refresh
  1867. with freezegun.freeze_time("2023-02-25 10:35:00"):
  1868. assert admin.connection.expires_at < datetime_parser.parse("2023-02-25 10:35:00")
  1869. admin.connection.token = None
  1870. assert admin.delete_realm(realm_name="test-refresh") == dict()
  1871. assert admin.connection.expires_at > datetime_parser.parse("2023-02-25 10:35:00")
  1872. def test_get_required_actions(admin: KeycloakAdmin, realm: str):
  1873. """Test required actions.
  1874. :param admin: Keycloak Admin client
  1875. :type admin: KeycloakAdmin
  1876. :param realm: Keycloak realm
  1877. :type realm: str
  1878. """
  1879. admin.realm_name = realm
  1880. ractions = admin.get_required_actions()
  1881. assert isinstance(ractions, list)
  1882. for ra in ractions:
  1883. for key in [
  1884. "alias",
  1885. "name",
  1886. "providerId",
  1887. "enabled",
  1888. "defaultAction",
  1889. "priority",
  1890. "config",
  1891. ]:
  1892. assert key in ra
  1893. def test_get_required_action_by_alias(admin: KeycloakAdmin, realm: str):
  1894. """Test get required action by alias.
  1895. :param admin: Keycloak Admin client
  1896. :type admin: KeycloakAdmin
  1897. :param realm: Keycloak realm
  1898. :type realm: str
  1899. """
  1900. admin.realm_name = realm
  1901. ractions = admin.get_required_actions()
  1902. ra = admin.get_required_action_by_alias("UPDATE_PASSWORD")
  1903. assert ra in ractions
  1904. assert ra["alias"] == "UPDATE_PASSWORD"
  1905. assert admin.get_required_action_by_alias("does-not-exist") is None
  1906. def test_update_required_action(admin: KeycloakAdmin, realm: str):
  1907. """Test update required action.
  1908. :param admin: Keycloak Admin client
  1909. :type admin: KeycloakAdmin
  1910. :param realm: Keycloak realm
  1911. :type realm: str
  1912. """
  1913. admin.realm_name = realm
  1914. ra = admin.get_required_action_by_alias("UPDATE_PASSWORD")
  1915. old = copy.deepcopy(ra)
  1916. ra["enabled"] = False
  1917. admin.update_required_action("UPDATE_PASSWORD", ra)
  1918. newra = admin.get_required_action_by_alias("UPDATE_PASSWORD")
  1919. assert old != newra
  1920. assert newra["enabled"] is False
  1921. def test_get_composite_client_roles_of_group(
  1922. admin: KeycloakAdmin, realm: str, client: str, group: str, composite_client_role: str
  1923. ):
  1924. """Test get composite client roles of group.
  1925. :param admin: Keycloak Admin client
  1926. :type admin: KeycloakAdmin
  1927. :param realm: Keycloak realm
  1928. :type realm: str
  1929. :param client: Keycloak client
  1930. :type client: str
  1931. :param group: Keycloak group
  1932. :type group: str
  1933. :param composite_client_role: Composite client role
  1934. :type composite_client_role: str
  1935. """
  1936. admin.realm_name = realm
  1937. role = admin.get_client_role(client, composite_client_role)
  1938. admin.assign_group_client_roles(group_id=group, client_id=client, roles=[role])
  1939. result = admin.get_composite_client_roles_of_group(client, group)
  1940. assert role["id"] in [x["id"] for x in result]
  1941. def test_get_role_client_level_children(
  1942. admin: KeycloakAdmin, realm: str, client: str, composite_client_role: str, client_role: str
  1943. ):
  1944. """Test get children of composite client role.
  1945. :param admin: Keycloak Admin client
  1946. :type admin: KeycloakAdmin
  1947. :param realm: Keycloak realm
  1948. :type realm: str
  1949. :param client: Keycloak client
  1950. :type client: str
  1951. :param composite_client_role: Composite client role
  1952. :type composite_client_role: str
  1953. :param client_role: Client role
  1954. :type client_role: str
  1955. """
  1956. admin.realm_name = realm
  1957. child = admin.get_client_role(client, client_role)
  1958. parent = admin.get_client_role(client, composite_client_role)
  1959. res = admin.get_role_client_level_children(client, parent["id"])
  1960. assert child["id"] in [x["id"] for x in res]
  1961. def test_upload_certificate(admin: KeycloakAdmin, realm: str, client: str, selfsigned_cert: tuple):
  1962. """Test upload certificate.
  1963. :param admin: Keycloak Admin client
  1964. :type admin: KeycloakAdmin
  1965. :param realm: Keycloak realm
  1966. :type realm: str
  1967. :param client: Keycloak client
  1968. :type client: str
  1969. :param selfsigned_cert: Selfsigned certificates
  1970. :type selfsigned_cert: tuple
  1971. """
  1972. admin.realm_name = realm
  1973. cert, _ = selfsigned_cert
  1974. cert = cert.decode("utf-8").strip()
  1975. admin.upload_certificate(client, cert)
  1976. cl = admin.get_client(client)
  1977. assert cl["attributes"]["jwt.credential.certificate"] == "".join(cert.splitlines()[1:-1])
  1978. def test_get_bruteforce_status_for_user(
  1979. admin: KeycloakAdmin, oid_with_credentials: Tuple[KeycloakOpenID, str, str], realm: str
  1980. ):
  1981. """Test users.
  1982. :param admin: Keycloak Admin client
  1983. :type admin: KeycloakAdmin
  1984. :param oid_with_credentials: Keycloak OpenID client with pre-configured user credentials
  1985. :type oid_with_credentials: Tuple[KeycloakOpenID, str, str]
  1986. :param realm: Keycloak realm
  1987. :type realm: str
  1988. """
  1989. oid, username, password = oid_with_credentials
  1990. admin.realm_name = realm
  1991. # Turn on bruteforce protection
  1992. res = admin.update_realm(realm_name=realm, payload={"bruteForceProtected": True})
  1993. res = admin.get_realm(realm_name=realm)
  1994. assert res["bruteForceProtected"] is True
  1995. # Test login user with wrong credentials
  1996. try:
  1997. oid.token(username=username, password="wrongpassword")
  1998. except KeycloakAuthenticationError:
  1999. pass
  2000. user_id = admin.get_user_id(username)
  2001. bruteforce_status = admin.get_bruteforce_detection_status(user_id)
  2002. assert bruteforce_status["numFailures"] == 1
  2003. # Cleanup
  2004. res = admin.update_realm(realm_name=realm, payload={"bruteForceProtected": False})
  2005. res = admin.get_realm(realm_name=realm)
  2006. assert res["bruteForceProtected"] is False
  2007. def test_clear_bruteforce_attempts_for_user(
  2008. admin: KeycloakAdmin, oid_with_credentials: Tuple[KeycloakOpenID, str, str], realm: str
  2009. ):
  2010. """Test users.
  2011. :param admin: Keycloak Admin client
  2012. :type admin: KeycloakAdmin
  2013. :param oid_with_credentials: Keycloak OpenID client with pre-configured user credentials
  2014. :type oid_with_credentials: Tuple[KeycloakOpenID, str, str]
  2015. :param realm: Keycloak realm
  2016. :type realm: str
  2017. """
  2018. oid, username, password = oid_with_credentials
  2019. admin.realm_name = realm
  2020. # Turn on bruteforce protection
  2021. res = admin.update_realm(realm_name=realm, payload={"bruteForceProtected": True})
  2022. res = admin.get_realm(realm_name=realm)
  2023. assert res["bruteForceProtected"] is True
  2024. # Test login user with wrong credentials
  2025. try:
  2026. oid.token(username=username, password="wrongpassword")
  2027. except KeycloakAuthenticationError:
  2028. pass
  2029. user_id = admin.get_user_id(username)
  2030. bruteforce_status = admin.get_bruteforce_detection_status(user_id)
  2031. assert bruteforce_status["numFailures"] == 1
  2032. res = admin.clear_bruteforce_attempts_for_user(user_id)
  2033. bruteforce_status = admin.get_bruteforce_detection_status(user_id)
  2034. assert bruteforce_status["numFailures"] == 0
  2035. # Cleanup
  2036. res = admin.update_realm(realm_name=realm, payload={"bruteForceProtected": False})
  2037. res = admin.get_realm(realm_name=realm)
  2038. assert res["bruteForceProtected"] is False
  2039. def test_clear_bruteforce_attempts_for_all_users(
  2040. admin: KeycloakAdmin, oid_with_credentials: Tuple[KeycloakOpenID, str, str], realm: str
  2041. ):
  2042. """Test users.
  2043. :param admin: Keycloak Admin client
  2044. :type admin: KeycloakAdmin
  2045. :param oid_with_credentials: Keycloak OpenID client with pre-configured user credentials
  2046. :type oid_with_credentials: Tuple[KeycloakOpenID, str, str]
  2047. :param realm: Keycloak realm
  2048. :type realm: str
  2049. """
  2050. oid, username, password = oid_with_credentials
  2051. admin.realm_name = realm
  2052. # Turn on bruteforce protection
  2053. res = admin.update_realm(realm_name=realm, payload={"bruteForceProtected": True})
  2054. res = admin.get_realm(realm_name=realm)
  2055. assert res["bruteForceProtected"] is True
  2056. # Test login user with wrong credentials
  2057. try:
  2058. oid.token(username=username, password="wrongpassword")
  2059. except KeycloakAuthenticationError:
  2060. pass
  2061. user_id = admin.get_user_id(username)
  2062. bruteforce_status = admin.get_bruteforce_detection_status(user_id)
  2063. assert bruteforce_status["numFailures"] == 1
  2064. res = admin.clear_all_bruteforce_attempts()
  2065. bruteforce_status = admin.get_bruteforce_detection_status(user_id)
  2066. assert bruteforce_status["numFailures"] == 0
  2067. # Cleanup
  2068. res = admin.update_realm(realm_name=realm, payload={"bruteForceProtected": False})
  2069. res = admin.get_realm(realm_name=realm)
  2070. assert res["bruteForceProtected"] is False
  2071. def test_default_realm_role_present(realm: str, admin: KeycloakAdmin) -> None:
  2072. """Test that the default realm role is present in a brand new realm.
  2073. :param realm: Realm name
  2074. :type realm: str
  2075. :param admin: Keycloak admin
  2076. :type admin: KeycloakAdmin
  2077. """
  2078. admin.realm_name = realm
  2079. assert f"default-roles-{realm}" in [x["name"] for x in admin.get_realm_roles()]
  2080. assert (
  2081. len([x["name"] for x in admin.get_realm_roles() if x["name"] == f"default-roles-{realm}"])
  2082. == 1
  2083. )
  2084. def test_get_default_realm_role_id(realm: str, admin: KeycloakAdmin) -> None:
  2085. """Test getter for the ID of the default realm role.
  2086. :param realm: Realm name
  2087. :type realm: str
  2088. :param admin: Keycloak admin
  2089. :type admin: KeycloakAdmin
  2090. """
  2091. admin.realm_name = realm
  2092. assert (
  2093. admin.get_default_realm_role_id()
  2094. == [x["id"] for x in admin.get_realm_roles() if x["name"] == f"default-roles-{realm}"][0]
  2095. )
  2096. def test_realm_default_roles(admin: KeycloakAdmin, realm: str) -> None:
  2097. """Test getting, adding and deleting default realm roles.
  2098. :param realm: Realm name
  2099. :type realm: str
  2100. :param admin: Keycloak admin
  2101. :type admin: KeycloakAdmin
  2102. """
  2103. admin.realm_name = realm
  2104. # Test listing all default realm roles
  2105. roles = admin.get_realm_default_roles()
  2106. assert len(roles) == 2
  2107. assert {x["name"] for x in roles} == {"offline_access", "uma_authorization"}
  2108. with pytest.raises(KeycloakGetError) as err:
  2109. admin.realm_name = "doesnotexist"
  2110. admin.get_realm_default_roles()
  2111. assert err.match('404: b\'{"error":"Realm not found."}\'')
  2112. admin.realm_name = realm
  2113. # Test removing a default realm role
  2114. res = admin.remove_realm_default_roles(payload=[roles[0]])
  2115. assert res == {}
  2116. assert roles[0] not in admin.get_realm_default_roles()
  2117. assert len(admin.get_realm_default_roles()) == 1
  2118. with pytest.raises(KeycloakDeleteError) as err:
  2119. admin.remove_realm_default_roles(payload=[{"id": "bad id"}])
  2120. assert err.match('404: b\'{"error":"Could not find composite role"}\'')
  2121. # Test adding a default realm role
  2122. res = admin.add_realm_default_roles(payload=[roles[0]])
  2123. assert res == {}
  2124. assert roles[0] in admin.get_realm_default_roles()
  2125. assert len(admin.get_realm_default_roles()) == 2
  2126. with pytest.raises(KeycloakPostError) as err:
  2127. admin.add_realm_default_roles(payload=[{"id": "bad id"}])
  2128. assert err.match('404: b\'{"error":"Could not find composite role"}\'')
  2129. def test_clear_keys_cache(realm: str, admin: KeycloakAdmin) -> None:
  2130. """Test clearing the keys cache.
  2131. :param realm: Realm name
  2132. :type realm: str
  2133. :param admin: Keycloak admin
  2134. :type admin: KeycloakAdmin
  2135. """
  2136. admin.realm_name = realm
  2137. res = admin.clear_keys_cache()
  2138. assert res == {}
  2139. def test_clear_realm_cache(realm: str, admin: KeycloakAdmin) -> None:
  2140. """Test clearing the realm cache.
  2141. :param realm: Realm name
  2142. :type realm: str
  2143. :param admin: Keycloak admin
  2144. :type admin: KeycloakAdmin
  2145. """
  2146. admin.realm_name = realm
  2147. res = admin.clear_realm_cache()
  2148. assert res == {}
  2149. def test_clear_user_cache(realm: str, admin: KeycloakAdmin) -> None:
  2150. """Test clearing the user cache.
  2151. :param realm: Realm name
  2152. :type realm: str
  2153. :param admin: Keycloak admin
  2154. :type admin: KeycloakAdmin
  2155. """
  2156. admin.realm_name = realm
  2157. res = admin.clear_user_cache()
  2158. assert res == {}