Merge pull request #15 from docusign/2.0.0-RC1-v2.1-1.4.0

Version 2.0.0-RC1 release

Author: vinz

.swagger-codegen/VERSION

@@ -1 +1 @@
-2.4.21-SNAPSHOT
+2.4.21

CHANGELOG.md

@@ -1,6 +1,42 @@
 # DocuSign Admin Java Client Changelog
 See [DocuSign Support Center](https://support.docusign.com/en/releasenotes/) for Product Release Notes.
 
+## [v2.0.0-RC1] - Admin API v2.1-1.4.0 - 2024-08-27
+### Breaking Changes
+<details>
+<summary>API Changes (Click to expand)</summary>
+
+<br/>
+<div style="margin-left: 20px;">
+
+Added new query parameter "include_ds_groups" to the API "/v2/organizations/{organizationId}/users":
+
+<h3>Added New APIs for Account Creation</h3>
+<li>GET: get subscription details for organization</li>
+<li>POST: initiate Create account request</li>
+<li>GET: get ongoing process details by org ID</li>
+<li>GET: get individual process details by org ID, asset group ID, asset group work ID</li>
+
+
+</div>
+</details>
+
+- Modified the default basePath to `DEMO_REST_BASEPATH`.
+- Deprecation of OLTU library: The OLTU library for handling OAuth is no longer used.
+ 
+### Other Changes
+- Revised the logic to determine the `oAuthBasePath` based on the `basePath`.
+- Model classes are now serializable.
+- Resolved an issue** where setting a default SSL socket for the entire JVM caused unintended side effects.
+- **Fixed a memory leak** related to the class loader.
+- **Addressed dependency vulnerabilities** in the following libraries:
+  - `bcprov-jdk18on` updated to version 1.78.1
+  - `com.fasterxml.jackson.core` updated to version 2.17.1
+  - `org.json` updated to version 20240303
+  - `jersey` updated to version 3.1.6
+- Upgradation of OWASP for vulnerability check of dependencies.
+- Added support for version v2.1-1.4.0 of the DocuSign Admin API.
+- Updated the SDK release version.
 ## [v1.3.0] - Admin API v2.1-1.3.0 - 2023-08-14
 ### Changed
 - Added support for version v2.1-1.3.0 of the DocuSign Admin API.

README.md

@@ -1,86 +1,119 @@
-# The Official DocuSign Admin Java Client
+# The Official Docusign Admin Java Client SDK
 
 [![Build status][travis-image]][travis-url]
 [![Maven Central status][maven-image]][maven-url]
 
-## Requirements
-
-- Java 1.9+
-- Free [Developer Sandbox](https://go.docusign.com/sandbox/productshot/?elqCampaignId=16531)
-
-## Compatibility
-
-- Java 1.9+
-
-## Note
+The Docusign SDK makes integrating Docusign into your apps and websites a seamless experience.
+
+## Table of Contents
+- [Introduction](#introduction)
+- [Installation](#installation)
+	* [Version Information](#versionInformation)
+	* [Requirements](#requirements)
+	* [Compatibility](#compatibility)
+	* [Maven](#maven)	
+- [Dependencies](#dependencies)
+- [API Reference](#apiReference)
+- [Code Examples](#codeExamples)
+- [OAuth Implementations](#oauthImplementations)
+- [Changelog](#changeLog)
+- [Support](#support)
+- [License](#license)
+- [Additional Resources](#additionalResources)
+
+<a id="introduction"></a>
+## Introduction
+The Docusign Admin API enables you to automate user management with your existing systems while ensuring governance and compliance.
+
+<a id="installation"></a>
+## Installation
+This client SDK is provided as open source, which enables you to customize its functionality to suit your particular use case. To do so, download or clone the repository. If the SDK’s given functionality meets your integration needs, or if you’re working through our [code examples](https://developers.docusign.com/docs/admin-api/how-to/) from the [Docusign Developer Center](https://developers.docusign.com/), you merely need to install it by following the instructions below.
 
-This open-source SDK is provided for cases where you would like to make additional changes that the SDK does not
- provide out-of-the-box. If you simply want to use the SDK with any of the examples shown in the [Developer Center ](https://developers.docusign.com/docs/admin-api), follow the installation instructions below.
+<a id="versionInformation"></a>
+### Version Information
+- **API version**: v2.1
+- **Latest SDK version (Including prerelease)**: 
 
-## Installation
+<a id="requirements"></a>
+## Requirements
+*   Java 1.9+
+*   Free [developer account](https://go.docusign.com/o/sandbox/?postActivateUrl=https://developers.docusign.com/)
 
-Note: DocuSign uses **Eclipse** with **Maven** for testing purposes.
+<a id="compatibility"></a>
+## Compatibility
+*   Java 1.9+
 
+<a id="maven"></a>
+**Note:** Docusign uses Eclipse with Maven for testing purposes.
 ### Maven:
-
-1. In Eclipse, create a new project by selecting **File** -> **New** -> **Project**.
-2. In the **New Project Wizard** , expand **Maven** , then select **Maven Project.**
+1. In Eclipse, create a new project by selecting **File > New > Project**.
+2. In the New Project Wizard, expand **Maven,** then select **Maven Project.**
 3. Leave **Create a simple project** unchecked.
-4. Select **Next** , then provide a unique **Group** and **Artifact Id**.
-5. In the directory where you've saved your project, open the _pom.xml_ file.
-6. In the _pom.xml_ file, locate the **dependencies** node.
-7. Add:
-
-```
-<dependency>
-  <groupId>com.docusign</groupId>
-  <artifactId>docusign-admin-java</artifactId>
-  <version>1.1.0</version>
-</dependency>
-```
-
-8. If your project is still open, restart **Eclipse**.
-
-## Dependencies
-
+4. Select **Next,** then provide a unique **groupId** and **artifactId.**
+5. In the directory where you've saved your project, open the pom.xml file.
+6. In the pom.xml file, locate the `dependencies` node.
+7. Add:  
+    ```
+    <dependency>
+      <groupId>com.docusign</groupId>
+      <artifactId>docusign-admin-java</artifactId>
+      <version>2.0.0-RC1</version>
+    </dependency>
+    ```
+8. If your project is still open, restart Eclipse.
+
+<a id="dependencies"></a>
+## SDK Dependencies
 This client has the following external dependencies:
-
-- io.swagger:swagger-annotations:jar:1.5.17
-- org.glassfish.jersey.core:jersey-client:jar:2.29.1
-- org.glassfish.jersey.media:jersey-media-multipart:jar:2.29.1
-- org.glassfish.jersey.media:jersey-media-json-jackson:2.29.1
-- com.fasterxml.jackson.core:jackson-core:jar:2.10.1
-- com.fasterxml.jackson.core:jackson-annotations:jar:2.10.1
-- com.fasterxml.jackson.core:jackson-databind:2.10.1
-- junit:junit:jar:4.12
-- com.apache.oltu.oauth2:org.apache.oltu.oauth2.client:1.0.2
-- com.auth0:java-jwt:3.4.1
-- org.bouncycastle:bcprov-jdk15on:1.60
-
-## OAuth Implementations
-
-For details regarding which type of OAuth grant will work best for your DocuSign integration, see the [REST API
- Authentication Overview](https://developers.docusign.com/docs/admin-api/admin101/auth/) guide located on the [DocuSign Developer Center](https://developers.docusign.com/).
-
-For security purposes, DocuSign recommends using the Authorization Code Grant flow.
-
+*   io.swagger.core.v3:swagger-annotations:2.2.8
+*   org.glassfish.jersey.core:jersey-client:3.1.6
+*   org.glassfish.jersey.media:jersey-media-multipart:3.1.6
+*   org.glassfish.jersey.media:jersey-media-json-jackson:3.1.6
+*   org.glassfish.jersey.inject:jersey-hk2:3.1.6
+*   com.fasterxml.jackson.jakarta.rs:jackson-jakarta-rs-base:2.14.2
+*   com.auth0:java-jwt:3.4.1
+*   org.bouncycastle:bcprov-jdk18on:1.78.1
+*   com.fasterxml.jackson.dataformat:jackson-dataformat-csv:2.14.2
+*   com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.14.2
+*   com.brsanthu:migbase64:2.2
+*   com.fasterxml.jackson.core:jackson-core:2.17.1
+*   org.json:json:20240303
+
+
+<a id="apiReference"></a>
+## API Reference
+You can refer to the API reference [here](https://developers.docusign.com/docs/admin-api/reference/).
+
+<a id="codeExamples"></a>
+## Code examples
+Explore our GitHub repository for the [Launcher](https://github.com/docusign/code-examples-java/), a self-executing package housing code examples for the Admin Java SDK. This package showcases several common use cases and their respective source files. Additionally, you can download a version preconfigured for your Docusign developer account from [Quickstart](https://developers.docusign.com/docs/esign-rest-api/quickstart/). These examples support both the [Authorization Code Grant](https://developers.docusign.com/platform/auth/authcode/) and [JSON Web Token (JWT)](https://developers.docusign.com/platform/auth/jwt/) authentication workflows.
+
+<a id="oauthImplementations"></a>
+## OAuth implementations
+For details regarding which type of OAuth grant will work best for your Docusign integration, see [Choose OAuth Type](https://developers.docusign.com/platform/auth/choose/) in the [Docusign Developer Center](https://developers.docusign.com/).
+
+For security purposes, Docusign recommends using the [Authorization Code Grant](https://developers.docusign.com/platform/auth/authcode/) flow.
+
+<a id="changeLog"></a>
+## Changelog
+You can refer to the complete changelog [here](https://github.com/docusign/docusign-admin-java-client/blob/master/CHANGELOG.md).
+
+<a id="support"></a>
 ## Support
+Log issues against this client SDK through GitHub. You can also reach out to us through [Docusign Community](https://community.docusign.com/developer-59) and [Stack Overflow](https://stackoverflow.com/questions/tagged/docusignapi).
 
-Log issues against this client through GitHub. We also have an [active developer community on Stack Overflow](https://stackoverflow.com/questions/tagged/docusignapi).
-
+<a id="license"></a>
 ## License
+The Docusign Admin Java Client SDK is licensed under the [MIT License](https://github.com/docusign/docusign-admin-java-client/blob/master/LICENSE).
 
-The DocuSign Java Client is licensed under the [MIT License](https://github.com/docusign/docusign-admin-java-client/blob
-/master/LICENSE).
-
+<a id="additionalResources"></a>
+### Additional resources
+*   [Docusign Developer Center](https://developers.docusign.com/)
+*   [Docusign API on Twitter](https://twitter.com/docusignapi)
+*   [Docusign For Developers on LinkedIn](https://www.linkedin.com/showcase/docusign-for-developers/)
+*   [Docusign For Developers on YouTube](https://www.youtube.com/channel/UCJSJ2kMs_qeQotmw4-lX2NQ)
 
 [travis-image]: https://api.travis-ci.com/docusign/docusign-admin-java-client.svg?branch=master
 [travis-url]: https://app.travis-ci.com/github/docusign/docusign-admin-java-client
-[maven-image]: https://img.shields.io/maven-central/v/com.docusign/docusign-admin-java.svg?style=flat
+[maven-image]: https://img.shields.io/maven-central/v/com.docusign/.svg?style=flat
 [maven-url]: https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.docusign%22
-
-### Additional Resources
-* [DocuSign Developer Center](https://developers.docusign.com)
-* [DocuSign API on Twitter](https://twitter.com/docusignapi)
-* [DocuSign For Developers on LinkedIn](https://www.linkedin.com/showcase/docusign-for-developers/)
-* [DocuSign For Developers on YouTube](https://www.youtube.com/channel/UCJSJ2kMs_qeQotmw4-lX2NQ)

pom.xml

@@ -5,9 +5,9 @@
     <artifactId>docusign-admin-java</artifactId>
     <packaging>jar</packaging>
     <name>docusign-admin-java</name>
-    <version>1.3.0</version>
+    <version>2.0.0-RC1</version>
     <url>https://developers.docusign.com</url>
-    <description>The DocuSign Admin API enables you to automate user management with your existing systems while ensuring governance and compliance.</description>
+    <description>The Docusign Admin API enables you to automate user management with your existing systems while ensuring governance and compliance.</description>
 
     <prerequisites>
         <maven>2.2.0</maven>
@@ -227,6 +227,21 @@
                     </execution>
                 </executions>
             </plugin>
+            <plugin>
+                <groupId>org.owasp</groupId>
+                <artifactId>dependency-check-maven</artifactId>
+                <version>10.0.2</version>
+                <configuration>
+                    <failBuildOnCVSS>8</failBuildOnCVSS>
+                </configuration>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>check</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
@@ -341,11 +356,6 @@
             <artifactId>jackson-jakarta-rs-base</artifactId>
             <version>${jackson-version}</version>
         </dependency>
-        <dependency>
-            <groupId>org.apache.oltu.oauth2</groupId>
-            <artifactId>org.apache.oltu.oauth2.client</artifactId>
-            <version>${oltu-version}</version>
-        </dependency>
         <!-- JWT signing and verifying -->
         <dependency>
             <groupId>com.auth0</groupId>
@@ -354,8 +364,8 @@
         </dependency>
         <dependency>
             <groupId>org.bouncycastle</groupId>
-            <artifactId>bcprov-jdk15on</artifactId>
-            <version>1.69</version>
+            <artifactId>bcprov-jdk18on</artifactId>
+            <version>1.78.1</version>
         </dependency>
         <dependency>
             <groupId>com.fasterxml.jackson.dataformat</groupId>
@@ -391,13 +401,28 @@
             <artifactId>migbase64</artifactId>
             <version>2.2</version>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <version>5.10.2</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-core</artifactId>
+            <version>2.17.1</version>
+        </dependency>
+        <dependency>
+            <groupId>org.json</groupId>
+            <artifactId>json</artifactId>
+            <version>20240303</version>
+        </dependency>
     </dependencies>
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <swagger-core-version>2.2.8</swagger-core-version>
-            <jersey-version>3.0.9</jersey-version>
+            <jersey-version>3.1.6</jersey-version>
         <jackson-version>2.14.2</jackson-version>
         <junit-version>4.13.1</junit-version>
-        <oltu-version>1.0.2</oltu-version>
     </properties>
 </project>

src/main/java/com/docusign/admin/api/AccountsApi.java

@@ -196,7 +196,7 @@ public ApiResponse<MemberGroupsResponse > getGroupsWithHttpInfo(java.util.UUID o
     };
     final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
 
-    String[] localVarAuthNames = new String[] {  };
+    String[] localVarAuthNames = new String[] { "docusignAccessCode" };
 
     GenericType<MemberGroupsResponse> localVarReturnType = new GenericType<MemberGroupsResponse>() {};
     MemberGroupsResponse localVarResponse = apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
@@ -289,7 +289,7 @@ public ApiResponse<OrganizationsResponse > getOrganizationsWithHttpInfo(Accounts
     };
     final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
 
-    String[] localVarAuthNames = new String[] {  };
+    String[] localVarAuthNames = new String[] { "docusignAccessCode" };
 
     GenericType<OrganizationsResponse> localVarReturnType = new GenericType<OrganizationsResponse>() {};
     OrganizationsResponse localVarResponse = apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
@@ -357,7 +357,7 @@ public ApiResponse<PermissionsResponse > getPermissionsWithHttpInfo(java.util.UU
     };
     final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
 
-    String[] localVarAuthNames = new String[] {  };
+    String[] localVarAuthNames = new String[] { "docusignAccessCode" };
 
     GenericType<PermissionsResponse> localVarReturnType = new GenericType<PermissionsResponse>() {};
     PermissionsResponse localVarResponse = apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
@@ -424,7 +424,7 @@ public ApiResponse<IndividualUserDataRedactionResponse > redactIndividualMembers
     };
     final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
 
-    String[] localVarAuthNames = new String[] {  };
+    String[] localVarAuthNames = new String[] { "docusignAccessCode" };
 
     GenericType<IndividualUserDataRedactionResponse> localVarReturnType = new GenericType<IndividualUserDataRedactionResponse>() {};
     IndividualUserDataRedactionResponse localVarResponse = apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);