sso-nebus 0.1.0__tar.gz → 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: sso-nebus
3
- Version: 0.1.0
3
+ Version: 0.1.1
4
4
  Summary: Python клиент для взаимодействия с MS Auth Service API
5
5
  License: LICENSE
6
6
  License-File: LICENSE
@@ -29,7 +29,7 @@ pip install -e .
29
29
  Или если пакет опубликован:
30
30
 
31
31
  ```bash
32
- pip install sso-nebus-client
32
+ pip install sso_nebus
33
33
  ```
34
34
 
35
35
  ## Быстрый старт
@@ -11,7 +11,7 @@ pip install -e .
11
11
  Или если пакет опубликован:
12
12
 
13
13
  ```bash
14
- pip install sso-nebus-client
14
+ pip install sso_nebus
15
15
  ```
16
16
 
17
17
  ## Быстрый старт
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "sso-nebus"
3
- version = "0.1.0"
3
+ version = "0.1.1"
4
4
  description = "Python клиент для взаимодействия с MS Auth Service API"
5
5
  authors = [
6
6
  {name = "Артем Костюченко",email = "kostyuchenko.work@gmail.com"}
@@ -6,9 +6,9 @@ SSO Nebus Client - Python клиент для взаимодействия с MS
6
6
  - ServiceClient: для микросервисного взаимодействия (Client Credentials)
7
7
  """
8
8
 
9
- from user_client import UserClient
10
- from service_client import ServiceClient
11
- from exceptions import (
9
+ from .user_client import UserClient
10
+ from .service_client import ServiceClient
11
+ from .exceptions import (
12
12
  SSOClientError,
13
13
  AuthenticationError,
14
14
  AuthorizationError,
@@ -0,0 +1,618 @@
1
+ """Базовый класс для SSO клиентов"""
2
+
3
+ from typing import Optional, Dict, Any
4
+ from urllib.parse import urljoin
5
+ from abc import ABC, abstractmethod
6
+
7
+ import aiohttp
8
+ from aiohttp import ClientSession, ClientResponse
9
+
10
+ from .exceptions import (
11
+ APIError,
12
+ AuthenticationError,
13
+ AuthorizationError,
14
+ TokenError,
15
+ )
16
+
17
+
18
+ class BaseClient(ABC):
19
+ """Базовый класс для всех SSO клиентов"""
20
+
21
+ def __init__(
22
+ self,
23
+ base_url: str,
24
+ api_version: str = "v1",
25
+ timeout: int = 30,
26
+ session: Optional[ClientSession] = None,
27
+ auto_refresh_token: bool = True,
28
+ ):
29
+ """
30
+ Инициализация базового клиента
31
+
32
+ Args:
33
+ base_url: Базовый URL API (например, "http://localhost:8000")
34
+ api_version: Версия API (по умолчанию "v1")
35
+ timeout: Таймаут запросов в секундах
36
+ session: Опциональная aiohttp сессия (если не указана, создается новая)
37
+ auto_refresh_token: Автоматически обновлять токен при получении 401 ошибки
38
+ """
39
+ self.base_url = base_url.rstrip("/")
40
+ self.api_version = api_version
41
+ self.timeout = aiohttp.ClientTimeout(total=timeout)
42
+ self._session = session
43
+ self._own_session = session is None
44
+ self.auto_refresh_token = auto_refresh_token
45
+ self._refreshing = False # Флаг для предотвращения рекурсивных обновлений
46
+
47
+ @property
48
+ def api_base_url(self) -> str:
49
+ """Базовый URL для API endpoints"""
50
+ return urljoin(self.base_url, f"/api/{self.api_version}/")
51
+
52
+ @property
53
+ def session(self) -> ClientSession:
54
+ """Получить или создать aiohttp сессию"""
55
+ if self._session is None:
56
+ self._session = aiohttp.ClientSession(timeout=self.timeout)
57
+ self._own_session = True
58
+ elif self._session.closed:
59
+ # Если сессия закрыта, создаем новую
60
+ self._session = aiohttp.ClientSession(timeout=self.timeout)
61
+ self._own_session = True
62
+ return self._session
63
+
64
+ async def close(self):
65
+ """Закрыть сессию (если она была создана клиентом)"""
66
+ if self._own_session and self._session and not self._session.closed:
67
+ await self._session.close()
68
+
69
+ async def __aenter__(self):
70
+ """Поддержка async context manager"""
71
+ return self
72
+
73
+ async def __aexit__(self, exc_type, exc_val, exc_tb):
74
+ """Закрытие сессии при выходе из context manager"""
75
+ await self.close()
76
+
77
+ def _build_url(self, endpoint: str) -> str:
78
+ """Построить полный URL для endpoint"""
79
+ endpoint = endpoint.lstrip("/")
80
+ return urljoin(self.api_base_url, endpoint)
81
+
82
+ def _get_headers(self, access_token: Optional[str] = None) -> Dict[str, str]:
83
+ """Получить заголовки для запроса"""
84
+ headers = {"Content-Type": "application/json"}
85
+ if access_token:
86
+ headers["Authorization"] = f"Bearer {access_token}"
87
+ return headers
88
+
89
+ @abstractmethod
90
+ async def _refresh_token(self) -> None:
91
+ """
92
+ Абстрактный метод для обновления токена.
93
+ Должен быть реализован в дочерних классах.
94
+ """
95
+ pass
96
+
97
+ def _get_access_token(self) -> Optional[str]:
98
+ """
99
+ Получить текущий access token.
100
+ Должен быть переопределен в дочерних классах.
101
+ """
102
+ return None
103
+
104
+ async def _handle_response(self, response: ClientResponse) -> Dict[str, Any]:
105
+ """
106
+ Обработать HTTP ответ
107
+
108
+ Args:
109
+ response: aiohttp ClientResponse
110
+
111
+ Returns:
112
+ Распарсенный JSON ответ
113
+
114
+ Raises:
115
+ APIError: При ошибках API
116
+ AuthenticationError: При ошибках аутентификации (401)
117
+ AuthorizationError: При ошибках авторизации (403)
118
+ """
119
+ try:
120
+ data = await response.json()
121
+ except aiohttp.ContentTypeError:
122
+ # Если ответ не JSON, пытаемся получить текст
123
+ text = await response.text()
124
+ data = {"detail": text} if text else {
125
+ "detail": "Неизвестная ошибка"}
126
+
127
+ if response.status == 401:
128
+ detail = data.get("detail", "Ошибка аутентификации")
129
+ raise AuthenticationError(detail)
130
+
131
+ if response.status == 403:
132
+ detail = data.get("detail", "Ошибка авторизации")
133
+ raise AuthorizationError(detail)
134
+
135
+ if not response.ok:
136
+ detail = data.get("detail", f"Ошибка API: {response.status}")
137
+ raise APIError(detail, status_code=response.status)
138
+
139
+ return data
140
+
141
+ async def _request(
142
+ self,
143
+ method: str,
144
+ endpoint: str,
145
+ access_token: Optional[str] = None,
146
+ json_data: Optional[Dict[str, Any]] = None,
147
+ form_data: Optional[Dict[str, Any]] = None,
148
+ params: Optional[Dict[str, Any]] = None,
149
+ retry_on_401: bool = True,
150
+ ) -> Dict[str, Any]:
151
+ """
152
+ Выполнить HTTP запрос с автоматическим обновлением токена при 401
153
+
154
+ Args:
155
+ method: HTTP метод (GET, POST, etc.)
156
+ endpoint: API endpoint (например, "auth/me")
157
+ access_token: Access token для авторизации (опционально)
158
+ json_data: JSON данные для тела запроса
159
+ form_data: Form data для тела запроса
160
+ params: Query параметры
161
+ retry_on_401: Повторить запрос после обновления токена при 401
162
+
163
+ Returns:
164
+ Распарсенный JSON ответ
165
+ """
166
+ # Используем сохраненный токен, если не передан явно
167
+ if access_token is None:
168
+ access_token = self._get_access_token()
169
+
170
+ url = self._build_url(endpoint)
171
+ headers = self._get_headers(access_token)
172
+
173
+ # Если form_data, меняем Content-Type
174
+ if form_data:
175
+ headers.pop("Content-Type", None)
176
+
177
+ async with self.session.request(
178
+ method=method,
179
+ url=url,
180
+ headers=headers,
181
+ json=json_data,
182
+ data=form_data,
183
+ params=params,
184
+ ) as response:
185
+ # Если получили 401 и включен авто-рефреш, пытаемся обновить токен
186
+ if (
187
+ response.status == 401
188
+ and self.auto_refresh_token
189
+ and retry_on_401
190
+ and not self._refreshing
191
+ and access_token
192
+ ):
193
+ try:
194
+ # Пытаемся обновить токен
195
+ self._refreshing = True
196
+ await self._refresh_token()
197
+ # Получаем новый токен
198
+ new_token = self._get_access_token()
199
+ if new_token and new_token != access_token:
200
+ # Повторяем запрос с новым токеном
201
+ headers = self._get_headers(new_token)
202
+ if form_data:
203
+ headers.pop("Content-Type", None)
204
+ async with self.session.request(
205
+ method=method,
206
+ url=url,
207
+ headers=headers,
208
+ json=json_data,
209
+ data=form_data,
210
+ params=params,
211
+ ) as retry_response:
212
+ return await self._handle_response(retry_response)
213
+ except Exception:
214
+ # Если обновление не удалось, пробрасываем оригинальную ошибку
215
+ pass
216
+ finally:
217
+ self._refreshing = False
218
+
219
+ return await self._handle_response(response)
220
+
221
+ async def get(
222
+ self,
223
+ endpoint: str,
224
+ access_token: Optional[str] = None,
225
+ params: Optional[Dict[str, Any]] = None,
226
+ use_auto_refresh: bool = True,
227
+ ) -> Dict[str, Any]:
228
+ """Выполнить GET запрос"""
229
+ return await self._request(
230
+ "GET",
231
+ endpoint,
232
+ access_token=access_token,
233
+ params=params,
234
+ retry_on_401=use_auto_refresh,
235
+ )
236
+
237
+ async def post(
238
+ self,
239
+ endpoint: str,
240
+ access_token: Optional[str] = None,
241
+ json_data: Optional[Dict[str, Any]] = None,
242
+ form_data: Optional[Dict[str, Any]] = None,
243
+ params: Optional[Dict[str, Any]] = None,
244
+ use_auto_refresh: bool = True,
245
+ ) -> Dict[str, Any]:
246
+ """Выполнить POST запрос"""
247
+ return await self._request(
248
+ "POST",
249
+ endpoint,
250
+ access_token=access_token,
251
+ json_data=json_data,
252
+ form_data=form_data,
253
+ params=params,
254
+ retry_on_401=use_auto_refresh,
255
+ )
256
+
257
+ async def put(
258
+ self,
259
+ endpoint: str,
260
+ access_token: Optional[str] = None,
261
+ json_data: Optional[Dict[str, Any]] = None,
262
+ params: Optional[Dict[str, Any]] = None,
263
+ use_auto_refresh: bool = True,
264
+ ) -> Dict[str, Any]:
265
+ """Выполнить PUT запрос"""
266
+ return await self._request(
267
+ "PUT",
268
+ endpoint,
269
+ access_token=access_token,
270
+ json_data=json_data,
271
+ params=params,
272
+ retry_on_401=use_auto_refresh,
273
+ )
274
+
275
+ async def delete(
276
+ self,
277
+ endpoint: str,
278
+ access_token: Optional[str] = None,
279
+ params: Optional[Dict[str, Any]] = None,
280
+ use_auto_refresh: bool = True,
281
+ ) -> Dict[str, Any]:
282
+ """Выполнить DELETE запрос"""
283
+ return await self._request(
284
+ "DELETE",
285
+ endpoint,
286
+ access_token=access_token,
287
+ params=params,
288
+ retry_on_401=use_auto_refresh,
289
+ )
290
+
291
+ # ========== Админские методы ==========
292
+
293
+ # Пользователи
294
+ async def create_user(
295
+ self,
296
+ login: str,
297
+ email: str,
298
+ password: str,
299
+ name: str,
300
+ surname: str,
301
+ lastname: Optional[str] = None,
302
+ access_token: Optional[str] = None,
303
+ ) -> Dict[str, Any]:
304
+ """Создать нового пользователя (требует sso.admin.create)"""
305
+ json_data = {
306
+ "login": login,
307
+ "email": email,
308
+ "password": password,
309
+ "name": name,
310
+ "surname": surname,
311
+ }
312
+ if lastname:
313
+ json_data["lastname"] = lastname
314
+ return await self.post("admin/users", access_token=access_token, json_data=json_data)
315
+
316
+ async def get_users(
317
+ self,
318
+ skip: int = 0,
319
+ limit: int = 100,
320
+ access_token: Optional[str] = None,
321
+ ) -> Dict[str, Any]:
322
+ """Получить список пользователей (требует sso.admin.read)"""
323
+ return await self.get(
324
+ "admin/users",
325
+ access_token=access_token,
326
+ params={"skip": skip, "limit": limit},
327
+ )
328
+
329
+ async def get_user(self, user_id: int, access_token: Optional[str] = None) -> Dict[str, Any]:
330
+ """Получить пользователя по ID (требует sso.admin.read)"""
331
+ return await self.get(f"admin/users/{user_id}", access_token=access_token)
332
+
333
+ async def update_user(
334
+ self,
335
+ user_id: int,
336
+ access_token: Optional[str] = None,
337
+ **kwargs,
338
+ ) -> Dict[str, Any]:
339
+ """Обновить пользователя (требует sso.admin.edit)"""
340
+ return await self.put(f"admin/users/{user_id}", access_token=access_token, json_data=kwargs)
341
+
342
+ async def delete_user(self, user_id: int, access_token: Optional[str] = None) -> Dict[str, Any]:
343
+ """Удалить пользователя (требует sso.admin.delete)"""
344
+ return await self.delete(f"admin/users/{user_id}", access_token=access_token)
345
+
346
+ # Роли
347
+ async def create_role(
348
+ self,
349
+ name: str,
350
+ display_name: str,
351
+ description: Optional[str] = None,
352
+ client_id: Optional[str] = None,
353
+ access_token: Optional[str] = None,
354
+ ) -> Dict[str, Any]:
355
+ """Создать новую роль (требует sso.admin.create)"""
356
+ json_data = {"name": name, "display_name": display_name}
357
+ if description:
358
+ json_data["description"] = description
359
+ if client_id:
360
+ json_data["client_id"] = client_id
361
+ return await self.post("admin/roles", access_token=access_token, json_data=json_data)
362
+
363
+ async def get_roles(
364
+ self,
365
+ skip: int = 0,
366
+ limit: int = 100,
367
+ client_id: Optional[str] = None,
368
+ access_token: Optional[str] = None,
369
+ ) -> Dict[str, Any]:
370
+ """Получить список ролей (требует sso.admin.read)"""
371
+ params = {"skip": skip, "limit": limit}
372
+ if client_id:
373
+ params["client_id"] = client_id
374
+ return await self.get("admin/roles", access_token=access_token, params=params)
375
+
376
+ async def get_role(self, role_id: int, access_token: Optional[str] = None) -> Dict[str, Any]:
377
+ """Получить роль по ID (требует sso.admin.read)"""
378
+ return await self.get(f"admin/roles/{role_id}", access_token=access_token)
379
+
380
+ async def update_role(
381
+ self,
382
+ role_id: int,
383
+ access_token: Optional[str] = None,
384
+ **kwargs,
385
+ ) -> Dict[str, Any]:
386
+ """Обновить роль (требует sso.admin.edit)"""
387
+ return await self.put(f"admin/roles/{role_id}", access_token=access_token, json_data=kwargs)
388
+
389
+ async def delete_role(self, role_id: int, access_token: Optional[str] = None) -> Dict[str, Any]:
390
+ """Удалить роль (требует sso.admin.delete)"""
391
+ return await self.delete(f"admin/roles/{role_id}", access_token=access_token)
392
+
393
+ # Разрешения (Scopes)
394
+ async def create_scope(
395
+ self,
396
+ name: str,
397
+ service_name: str,
398
+ resource: str,
399
+ action: str,
400
+ description: Optional[str] = None,
401
+ access_token: Optional[str] = None,
402
+ ) -> Dict[str, Any]:
403
+ """Создать новое разрешение (требует sso.admin.create)"""
404
+ json_data = {
405
+ "name": name,
406
+ "service_name": service_name,
407
+ "resource": resource,
408
+ "action": action,
409
+ }
410
+ if description:
411
+ json_data["description"] = description
412
+ return await self.post("admin/scopes", access_token=access_token, json_data=json_data)
413
+
414
+ async def get_scopes(
415
+ self,
416
+ skip: int = 0,
417
+ limit: int = 100,
418
+ access_token: Optional[str] = None,
419
+ ) -> Dict[str, Any]:
420
+ """Получить список разрешений (требует sso.admin.read)"""
421
+ return await self.get(
422
+ "admin/scopes",
423
+ access_token=access_token,
424
+ params={"skip": skip, "limit": limit},
425
+ )
426
+
427
+ async def get_scope(self, scope_id: int, access_token: Optional[str] = None) -> Dict[str, Any]:
428
+ """Получить разрешение по ID (требует sso.admin.read)"""
429
+ return await self.get(f"admin/scopes/{scope_id}", access_token=access_token)
430
+
431
+ async def update_scope(
432
+ self,
433
+ scope_id: int,
434
+ access_token: Optional[str] = None,
435
+ **kwargs,
436
+ ) -> Dict[str, Any]:
437
+ """Обновить разрешение (требует sso.admin.edit)"""
438
+ return await self.put(f"admin/scopes/{scope_id}", access_token=access_token, json_data=kwargs)
439
+
440
+ async def delete_scope(self, scope_id: int, access_token: Optional[str] = None) -> Dict[str, Any]:
441
+ """Удалить разрешение (требует sso.admin.delete)"""
442
+ return await self.delete(f"admin/scopes/{scope_id}", access_token=access_token)
443
+
444
+ # Микросервисы (Clients)
445
+ async def create_client(
446
+ self,
447
+ service_name: str,
448
+ access_token: Optional[str] = None,
449
+ ) -> Dict[str, Any]:
450
+ """Создать новый микросервис (требует sso.admin.create)"""
451
+ return await self.post("admin/clients", access_token=access_token, json_data={"service_name": service_name})
452
+
453
+ async def get_clients(
454
+ self,
455
+ skip: int = 0,
456
+ limit: int = 100,
457
+ access_token: Optional[str] = None,
458
+ ) -> Dict[str, Any]:
459
+ """Получить список клиентов (требует sso.admin.read)"""
460
+ return await self.get(
461
+ "admin/clients",
462
+ access_token=access_token,
463
+ params={"skip": skip, "limit": limit},
464
+ )
465
+
466
+ async def get_client(self, client_id: str, access_token: Optional[str] = None) -> Dict[str, Any]:
467
+ """Получить клиента по ID (требует sso.admin.read)"""
468
+ return await self.get(f"admin/clients/{client_id}", access_token=access_token)
469
+
470
+ async def update_client(
471
+ self,
472
+ client_id: str,
473
+ access_token: Optional[str] = None,
474
+ **kwargs,
475
+ ) -> Dict[str, Any]:
476
+ """Обновить клиента (требует sso.admin.edit)"""
477
+ return await self.put(f"admin/clients/{client_id}", access_token=access_token, json_data=kwargs)
478
+
479
+ async def assign_scopes_to_client(
480
+ self,
481
+ client_id: str,
482
+ scope_ids: list[int],
483
+ access_token: Optional[str] = None,
484
+ ) -> Dict[str, Any]:
485
+ """Назначить разрешения клиенту (требует sso.admin.edit)"""
486
+ return await self.post(
487
+ f"admin/clients/{client_id}/scopes",
488
+ access_token=access_token,
489
+ json_data={"scope_ids": scope_ids},
490
+ )
491
+
492
+ async def rotate_client_secret(
493
+ self,
494
+ client_id: str,
495
+ access_token: Optional[str] = None,
496
+ ) -> Dict[str, Any]:
497
+ """Ротация client_secret (требует sso.admin.edit)"""
498
+ return await self.post(f"admin/clients/{client_id}/rotate-secret", access_token=access_token)
499
+
500
+ # Назначение ролей пользователям
501
+ async def assign_role_to_user(
502
+ self,
503
+ user_id: int,
504
+ role_id: int,
505
+ access_token: Optional[str] = None,
506
+ ) -> Dict[str, Any]:
507
+ """Назначить роль пользователю (требует sso.admin.create)"""
508
+ return await self.post(
509
+ f"admin/user-roles/{user_id}/roles",
510
+ access_token=access_token,
511
+ json_data={"role_id": role_id},
512
+ )
513
+
514
+ async def revoke_role_from_user(
515
+ self,
516
+ user_id: int,
517
+ role_id: int,
518
+ access_token: Optional[str] = None,
519
+ ) -> Dict[str, Any]:
520
+ """Отозвать роль у пользователя (требует sso.admin.delete)"""
521
+ return await self.delete(
522
+ f"admin/user-roles/{user_id}/roles/{role_id}",
523
+ access_token=access_token,
524
+ )
525
+
526
+ async def get_user_roles(
527
+ self,
528
+ user_id: int,
529
+ access_token: Optional[str] = None,
530
+ ) -> Dict[str, Any]:
531
+ """Получить роли пользователя (требует sso.admin.read)"""
532
+ return await self.get(f"admin/user-roles/{user_id}/roles", access_token=access_token)
533
+
534
+ async def get_user_scopes(
535
+ self,
536
+ user_id: int,
537
+ access_token: Optional[str] = None,
538
+ ) -> Dict[str, Any]:
539
+ """Получить разрешения пользователя (требует sso.admin.read)"""
540
+ return await self.get(f"admin/user-roles/{user_id}/scopes", access_token=access_token)
541
+
542
+ async def get_users_with_roles(
543
+ self,
544
+ skip: int = 0,
545
+ limit: int = 100,
546
+ access_token: Optional[str] = None,
547
+ ) -> Dict[str, Any]:
548
+ """Получить список пользователей с их ролями (требует sso.admin.read)"""
549
+ return await self.get(
550
+ "admin/user-roles",
551
+ access_token=access_token,
552
+ params={"skip": skip, "limit": limit},
553
+ )
554
+
555
+ # Логи
556
+ async def get_role_logs(
557
+ self,
558
+ skip: int = 0,
559
+ limit: int = 100,
560
+ user_id: Optional[int] = None,
561
+ search: Optional[str] = None,
562
+ access_token: Optional[str] = None,
563
+ ) -> Dict[str, Any]:
564
+ """Получить логи действий с ролями (требует sso.admin.read)"""
565
+ params = {"skip": skip, "limit": limit}
566
+ if user_id:
567
+ params["user_id"] = user_id
568
+ if search:
569
+ params["search"] = search
570
+ return await self.get("logs/role", access_token=access_token, params=params)
571
+
572
+ async def get_user_logs(
573
+ self,
574
+ skip: int = 0,
575
+ limit: int = 100,
576
+ user_id: Optional[int] = None,
577
+ search: Optional[str] = None,
578
+ access_token: Optional[str] = None,
579
+ ) -> Dict[str, Any]:
580
+ """Получить логи действий с пользователями (требует sso.admin.read)"""
581
+ params = {"skip": skip, "limit": limit}
582
+ if user_id:
583
+ params["user_id"] = user_id
584
+ if search:
585
+ params["search"] = search
586
+ return await self.get("logs/user", access_token=access_token, params=params)
587
+
588
+ async def get_auth_logs(
589
+ self,
590
+ skip: int = 0,
591
+ limit: int = 100,
592
+ user_id: Optional[int] = None,
593
+ search: Optional[str] = None,
594
+ access_token: Optional[str] = None,
595
+ ) -> Dict[str, Any]:
596
+ """Получить логи действий авторизации (требует sso.admin.read)"""
597
+ params = {"skip": skip, "limit": limit}
598
+ if user_id:
599
+ params["user_id"] = user_id
600
+ if search:
601
+ params["search"] = search
602
+ return await self.get("logs/auth", access_token=access_token, params=params)
603
+
604
+ async def get_service_logs(
605
+ self,
606
+ skip: int = 0,
607
+ limit: int = 100,
608
+ user_id: Optional[int] = None,
609
+ search: Optional[str] = None,
610
+ access_token: Optional[str] = None,
611
+ ) -> Dict[str, Any]:
612
+ """Получить логи действий сервисов (требует sso.admin.read)"""
613
+ params = {"skip": skip, "limit": limit}
614
+ if user_id:
615
+ params["user_id"] = user_id
616
+ if search:
617
+ params["search"] = search
618
+ return await self.get("logs/service", access_token=access_token, params=params)
@@ -0,0 +1,53 @@
1
+ """Пример использования UserClient"""
2
+
3
+ import asyncio
4
+
5
+ from user_client import UserClient
6
+
7
+
8
+ async def main():
9
+ # Создаем клиент
10
+ client = UserClient(
11
+ base_url="http://localhost:8000",
12
+ client_id="your_client_id"
13
+ )
14
+
15
+ try:
16
+ # Полный цикл авторизации
17
+ token_response = await client.full_auth_flow(
18
+ login="admin",
19
+ password="SecretPassword123!",
20
+ scope="sso.admin.read sso.admin.create",
21
+ )
22
+
23
+ print(f"Access token: {token_response.access_token[:50]}...")
24
+ print(
25
+ f"Refresh token: {token_response.refresh_token[:50] if token_response.refresh_token else None}...")
26
+ print(f"Expires in: {token_response.expires_in} seconds")
27
+
28
+ # Получаем информацию о пользователе
29
+ user_info = await client.get_current_user()
30
+ print(f"\nПользователь: {user_info.name} {user_info.surname}")
31
+ print(f"Email: {user_info.email}")
32
+ print(f"Scopes: {user_info.scopes}")
33
+
34
+ # Обновляем токен
35
+ new_token = await client.refresh_access_token()
36
+ print(
37
+ f"\nНовый access token получен: {new_token.access_token[:50]}...")
38
+
39
+ # Получаем список доступных сервисов
40
+ services = await client.get_available_services()
41
+ print(f"\nДоступно сервисов: {len(services.services)}")
42
+ for service in services.services:
43
+ print(f" - {service.name} ({service.client_id})")
44
+
45
+ except Exception as e:
46
+ print(f"Ошибка: {e}")
47
+
48
+ finally:
49
+ await client.close()
50
+
51
+
52
+ if __name__ == "__main__":
53
+ asyncio.run(main())
@@ -16,8 +16,8 @@ async def main():
16
16
  try:
17
17
  # Полный цикл авторизации
18
18
  token_response = await client.full_auth_flow(
19
- login="user@example.com",
20
- password="password123",
19
+ login="user",
20
+ password="SimplePassword123!",
21
21
  scope="sso.admin.read sso.admin.create",
22
22
  )
23
23
 
@@ -2,9 +2,9 @@
2
2
 
3
3
  from typing import Optional
4
4
 
5
- from base import BaseClient
6
- from models import TokenResponse, UserInfo
7
- from exceptions import TokenError
5
+ from .base import BaseClient
6
+ from .models import TokenResponse, UserInfo
7
+ from .exceptions import TokenError
8
8
 
9
9
 
10
10
  class ServiceClient(BaseClient):
@@ -18,6 +18,8 @@ class ServiceClient(BaseClient):
18
18
  api_version: str = "v1",
19
19
  timeout: int = 30,
20
20
  session=None,
21
+ auto_refresh_token: bool = True,
22
+ default_scope: Optional[str] = None,
21
23
  ):
22
24
  """
23
25
  Инициализация клиента для микросервисов
@@ -29,11 +31,14 @@ class ServiceClient(BaseClient):
29
31
  api_version: Версия API
30
32
  timeout: Таймаут запросов
31
33
  session: Опциональная aiohttp сессия
34
+ auto_refresh_token: Автоматически обновлять токен при получении 401 ошибки
35
+ default_scope: Scope по умолчанию для автоматического получения токена
32
36
  """
33
- super().__init__(base_url, api_version, timeout, session)
37
+ super().__init__(base_url, api_version, timeout, session, auto_refresh_token)
34
38
  self.client_id = client_id
35
39
  self.client_secret = client_secret
36
40
  self._access_token: Optional[str] = None
41
+ self.default_scope = default_scope
37
42
 
38
43
  async def get_access_token(self, scope: Optional[str] = None) -> TokenResponse:
39
44
  """
@@ -90,6 +95,14 @@ class ServiceClient(BaseClient):
90
95
  """
91
96
  self._access_token = access_token
92
97
 
98
+ def _get_access_token(self) -> Optional[str]:
99
+ """Получить текущий access token (для BaseClient)"""
100
+ return self._access_token
101
+
102
+ async def _refresh_token(self) -> None:
103
+ """Обновить access token (для авто-рефреша)"""
104
+ await self.get_access_token(self.default_scope)
105
+
93
106
  def get_token(self) -> Optional[str]:
94
107
  """Получить текущий access token"""
95
108
  return self._access_token
@@ -5,8 +5,8 @@ import hashlib
5
5
  import base64
6
6
  import secrets
7
7
 
8
- from base import BaseClient
9
- from models import (
8
+ from .base import BaseClient
9
+ from .models import (
10
10
  PKCEParams,
11
11
  TokenResponse,
12
12
  UserInfo,
@@ -14,7 +14,7 @@ from models import (
14
14
  LoginResponse,
15
15
  ServicesList,
16
16
  )
17
- from exceptions import TokenError
17
+ from .exceptions import TokenError
18
18
 
19
19
 
20
20
  class UserClient(BaseClient):
@@ -28,6 +28,7 @@ class UserClient(BaseClient):
28
28
  api_version: str = "v1",
29
29
  timeout: int = 30,
30
30
  session=None,
31
+ auto_refresh_token: bool = True,
31
32
  ):
32
33
  """
33
34
  Инициализация клиента для пользователей
@@ -39,8 +40,9 @@ class UserClient(BaseClient):
39
40
  api_version: Версия API
40
41
  timeout: Таймаут запросов
41
42
  session: Опциональная aiohttp сессия
43
+ auto_refresh_token: Автоматически обновлять токен при получении 401 ошибки
42
44
  """
43
- super().__init__(base_url, api_version, timeout, session)
45
+ super().__init__(base_url, api_version, timeout, session, auto_refresh_token)
44
46
  self.client_id = client_id
45
47
  self.redirect_uri = redirect_uri
46
48
  self._pkce_params: Optional[PKCEParams] = None
@@ -275,6 +277,16 @@ class UserClient(BaseClient):
275
277
  data = await self.get("auth/services")
276
278
  return ServicesList(**data)
277
279
 
280
+ def _get_access_token(self) -> Optional[str]:
281
+ """Получить текущий access token (для BaseClient)"""
282
+ return self._access_token
283
+
284
+ async def _refresh_token(self) -> None:
285
+ """Обновить access token используя refresh token (для авто-рефреша)"""
286
+ if not self._refresh_token:
287
+ raise TokenError("Refresh token не найден. Выполните авторизацию сначала.")
288
+ await self.refresh_access_token(self._refresh_token)
289
+
278
290
  def get_access_token(self) -> Optional[str]:
279
291
  """Получить текущий access token"""
280
292
  return self._access_token
@@ -1,204 +0,0 @@
1
- """Базовый класс для SSO клиентов"""
2
-
3
- from typing import Optional, Dict, Any
4
- from urllib.parse import urljoin
5
-
6
- import aiohttp
7
- from aiohttp import ClientSession, ClientResponse
8
-
9
- from exceptions import (
10
- APIError,
11
- AuthenticationError,
12
- AuthorizationError,
13
- )
14
-
15
-
16
- class BaseClient:
17
- """Базовый класс для всех SSO клиентов"""
18
-
19
- def __init__(
20
- self,
21
- base_url: str,
22
- api_version: str = "v1",
23
- timeout: int = 30,
24
- session: Optional[ClientSession] = None,
25
- ):
26
- """
27
- Инициализация базового клиента
28
-
29
- Args:
30
- base_url: Базовый URL API (например, "http://localhost:8000")
31
- api_version: Версия API (по умолчанию "v1")
32
- timeout: Таймаут запросов в секундах
33
- session: Опциональная aiohttp сессия (если не указана, создается новая)
34
- """
35
- self.base_url = base_url.rstrip("/")
36
- self.api_version = api_version
37
- self.timeout = aiohttp.ClientTimeout(total=timeout)
38
- self._session = session
39
- self._own_session = session is None
40
-
41
- @property
42
- def api_base_url(self) -> str:
43
- """Базовый URL для API endpoints"""
44
- return urljoin(self.base_url, f"/api/{self.api_version}/")
45
-
46
- @property
47
- def session(self) -> ClientSession:
48
- """Получить или создать aiohttp сессию"""
49
- if self._session is None:
50
- self._session = aiohttp.ClientSession(timeout=self.timeout)
51
- self._own_session = True
52
- elif self._session.closed:
53
- # Если сессия закрыта, создаем новую
54
- self._session = aiohttp.ClientSession(timeout=self.timeout)
55
- self._own_session = True
56
- return self._session
57
-
58
- async def close(self):
59
- """Закрыть сессию (если она была создана клиентом)"""
60
- if self._own_session and self._session and not self._session.closed:
61
- await self._session.close()
62
-
63
- async def __aenter__(self):
64
- """Поддержка async context manager"""
65
- return self
66
-
67
- async def __aexit__(self, exc_type, exc_val, exc_tb):
68
- """Закрытие сессии при выходе из context manager"""
69
- await self.close()
70
-
71
- def _build_url(self, endpoint: str) -> str:
72
- """Построить полный URL для endpoint"""
73
- endpoint = endpoint.lstrip("/")
74
- return urljoin(self.api_base_url, endpoint)
75
-
76
- def _get_headers(self, access_token: Optional[str] = None) -> Dict[str, str]:
77
- """Получить заголовки для запроса"""
78
- headers = {"Content-Type": "application/json"}
79
- if access_token:
80
- headers["Authorization"] = f"Bearer {access_token}"
81
- return headers
82
-
83
- async def _handle_response(self, response: ClientResponse) -> Dict[str, Any]:
84
- """
85
- Обработать HTTP ответ
86
-
87
- Args:
88
- response: aiohttp ClientResponse
89
-
90
- Returns:
91
- Распарсенный JSON ответ
92
-
93
- Raises:
94
- APIError: При ошибках API
95
- AuthenticationError: При ошибках аутентификации (401)
96
- AuthorizationError: При ошибках авторизации (403)
97
- """
98
- try:
99
- data = await response.json()
100
- except aiohttp.ContentTypeError:
101
- # Если ответ не JSON, пытаемся получить текст
102
- text = await response.text()
103
- data = {"detail": text} if text else {
104
- "detail": "Неизвестная ошибка"}
105
-
106
- if response.status == 401:
107
- detail = data.get("detail", "Ошибка аутентификации")
108
- raise AuthenticationError(detail)
109
-
110
- if response.status == 403:
111
- detail = data.get("detail", "Ошибка авторизации")
112
- raise AuthorizationError(detail)
113
-
114
- if not response.ok:
115
- detail = data.get("detail", f"Ошибка API: {response.status}")
116
- raise APIError(detail, status_code=response.status)
117
-
118
- return data
119
-
120
- async def _request(
121
- self,
122
- method: str,
123
- endpoint: str,
124
- access_token: Optional[str] = None,
125
- json_data: Optional[Dict[str, Any]] = None,
126
- form_data: Optional[Dict[str, Any]] = None,
127
- params: Optional[Dict[str, Any]] = None,
128
- ) -> Dict[str, Any]:
129
- """
130
- Выполнить HTTP запрос
131
-
132
- Args:
133
- method: HTTP метод (GET, POST, etc.)
134
- endpoint: API endpoint (например, "auth/me")
135
- access_token: Access token для авторизации (опционально)
136
- json_data: JSON данные для тела запроса
137
- form_data: Form data для тела запроса
138
- params: Query параметры
139
-
140
- Returns:
141
- Распарсенный JSON ответ
142
- """
143
- url = self._build_url(endpoint)
144
- headers = self._get_headers(access_token)
145
-
146
- # Если form_data, меняем Content-Type
147
- if form_data:
148
- headers.pop("Content-Type", None)
149
-
150
- async with self.session.request(
151
- method=method,
152
- url=url,
153
- headers=headers,
154
- json=json_data,
155
- data=form_data,
156
- params=params,
157
- ) as response:
158
- return await self._handle_response(response)
159
-
160
- async def get(
161
- self,
162
- endpoint: str,
163
- access_token: Optional[str] = None,
164
- params: Optional[Dict[str, Any]] = None,
165
- ) -> Dict[str, Any]:
166
- """Выполнить GET запрос"""
167
- return await self._request("GET", endpoint, access_token=access_token, params=params)
168
-
169
- async def post(
170
- self,
171
- endpoint: str,
172
- access_token: Optional[str] = None,
173
- json_data: Optional[Dict[str, Any]] = None,
174
- form_data: Optional[Dict[str, Any]] = None,
175
- params: Optional[Dict[str, Any]] = None,
176
- ) -> Dict[str, Any]:
177
- """Выполнить POST запрос"""
178
- return await self._request(
179
- "POST",
180
- endpoint,
181
- access_token=access_token,
182
- json_data=json_data,
183
- form_data=form_data,
184
- params=params,
185
- )
186
-
187
- async def put(
188
- self,
189
- endpoint: str,
190
- access_token: Optional[str] = None,
191
- json_data: Optional[Dict[str, Any]] = None,
192
- params: Optional[Dict[str, Any]] = None,
193
- ) -> Dict[str, Any]:
194
- """Выполнить PUT запрос"""
195
- return await self._request("PUT", endpoint, access_token=access_token, json_data=json_data, params=params)
196
-
197
- async def delete(
198
- self,
199
- endpoint: str,
200
- access_token: Optional[str] = None,
201
- params: Optional[Dict[str, Any]] = None,
202
- ) -> Dict[str, Any]:
203
- """Выполнить DELETE запрос"""
204
- return await self._request("DELETE", endpoint, access_token=access_token, params=params)
File without changes
File without changes