Merge pull request #43 from FusionAuth/lyle/ENG-2742/change-password-using-jwt

changePasswordUsingJWT

Author: lyleschemmerling

lib/fusionauth/fusionauth_client.rb

@@ -143,6 +143,7 @@ def change_password(change_password_id, request)
     # @param encoded_jwt [string] The encoded JWT (access token).
     # @param request [OpenStruct, Hash] The change password request that contains all the information used to change the password.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    # @deprecated This method has been renamed to change_password_using_jwt, use that method instead.
     def change_password_by_jwt(encoded_jwt, request)
       startAnonymous.uri('/api/user/change-password')
           .authorization('Bearer ' + encoded_jwt)
@@ -165,6 +166,23 @@ def change_password_by_identity(request)
           .go
     end
 
+    #
+    # Changes a user's password using their access token (JWT) instead of the changePasswordId
+    # A common use case for this method will be if you want to allow the user to change their own password.
+    # 
+    # Remember to send refreshToken in the request body if you want to get a new refresh token when login using the returned oneTimePassword.
+    #
+    # @param encoded_jwt [string] The encoded JWT (access token).
+    # @param request [OpenStruct, Hash] The change password request that contains all the information used to change the password.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def change_password_using_jwt(encoded_jwt, request)
+      startAnonymous.uri('/api/user/change-password')
+          .authorization('Bearer ' + encoded_jwt)
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .post
+          .go
+    end
+
     #
     # Check to see if the user must obtain a Trust Token Id in order to complete a change password request.
     # When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change