Bug 2084166

Summary:	[RFE] IdM Server stable API
Product:	Red Hat Enterprise Linux 9	Reporter:	Florence Blanc-Renaud <frenaud>
Component:	ipa	Assignee:	Florence Blanc-Renaud <frenaud>
Status:	CLOSED CURRENTRELEASE	QA Contact:	ipa-qe <ipa-qe>
Severity:	medium	Docs Contact:	Filip Hanzelka <fhanzelk>
Priority:	high
Version:	9.0	CC:	akasurde, dkupka, fhanzelk, ipa-maint, jcholast, mjahoda, mkosek, nsoman, pasik, pvoborni, rcritten, tscherf
Target Milestone:	rc	Keywords:	FutureFeature, TechPreview
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Enhancement
Doc Text:	.Identity Management JSON-RPC API is now available An API is now available for Identity Management (IdM). IdM also provides an API browser for system administrators to view the API. Previously, the IdM API was enhanced to enable multiple versions of API commands. These enhancements could change the behavior of a command in an incompatible way. Users are now able to continue using existing tools and scripts even if the IdM API changes. This enables the following: * Administrators can use previous or later versions of IdM on the server than on the managing client. * Developers can use a specific version of an IdM call, even if the IdM version changes on the server. In all cases, the communication with the server is possible, regardless if one side uses, for example, a newer version that introduces new options for a feature. For details on using the API, see link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/using_idm_api/index[Using IdM API].	Story Points:	---
Clone Of:	1298286	Environment:
Last Closed:	2022-06-22 15:08:54 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1298286
Bug Blocks:	1292074, 1296125, 1313485, 1351228, 1381130, 1664719

Description Florence Blanc-Renaud 2022-05-11 14:55:24 UTC

This bug is created to track availability of IdM server stable API feature introduced in RHEL-7, in Bug 1298286 and denote that it is still being offered as TechPreview.

+++ This bug was initially created as a clone of Bug #1298286 +++

As a Developer of a Product, I want to call a specific version of API call, without being affected by higher or lower version of the IdM server than my testing instance so that the Product is not dependent on a specific IdM server version and respective changes

Version-Release number of selected component (if applicable):
4.2

How reproducible:
always

Steps to Reproduce:
1. run any 'ipa' command from client newer than an IPA server. E.g. user-find

Actual results:
There is only "one" API, API version is used only for rejecting request and not managing requests.

Expected results:
Client can call API with API version specified. Server will respond according to the specified version(different output/required params, etc.).

The supported versions are yet to be determined.

Comment 2 Florence Blanc-Renaud 2022-06-22 15:08:54 UTC

The release notes for RHEL 9.0 [1] properly document that Identity Management JSON-RPC API is available as Technology Preview. Closing as CURRENTRELEASE.

[1] https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/9.0_release_notes/index#technology-preview_identity-management