Adding support for password reset via Okta's API.

We will likely need to change this, to configuring an email server and sending out a mail via a templated message.

Author: bdemers

api/src/main/java/com/stormpath/sdk/application/okta/OktaForgotPasswordRequest.java

@@ -0,0 +1,18 @@
+package com.stormpath.sdk.application.okta;
+
+import com.stormpath.sdk.resource.Resource;
+
+/**
+ *
+ */
+public interface OktaForgotPasswordRequest extends Resource {
+
+    String getUsername();
+    OktaForgotPasswordRequest setUsername(String username);
+
+    String getFactorType();
+    OktaForgotPasswordRequest setFactorType(String factorType);
+
+    String getRelayState();
+    OktaForgotPasswordRequest setRelayState(String relayState);
+}

api/src/main/java/com/stormpath/sdk/application/okta/OktaForgotPasswordResult.java

@@ -0,0 +1,16 @@
+package com.stormpath.sdk.application.okta;
+
+import com.stormpath.sdk.resource.Resource;
+
+/**
+ *
+ */
+public interface OktaForgotPasswordResult extends Resource {
+
+    String getStatus();
+    String getFactorResult();
+    String getRelayState();
+    String getFactorType();
+    String getRecoveryType();
+
+}

impl/src/main/java/com/stormpath/sdk/impl/application/okta/DefaultOktaForgotPasswordRequest.java

@@ -0,0 +1,63 @@
+package com.stormpath.sdk.impl.application.okta;
+
+import com.stormpath.sdk.application.okta.OktaForgotPasswordRequest;
+import com.stormpath.sdk.impl.ds.InternalDataStore;
+import com.stormpath.sdk.impl.resource.AbstractInstanceResource;
+import com.stormpath.sdk.impl.resource.Property;
+import com.stormpath.sdk.impl.resource.StringProperty;
+
+import java.util.Map;
+
+/**
+ *
+ */
+public class DefaultOktaForgotPasswordRequest extends AbstractInstanceResource implements OktaForgotPasswordRequest {
+
+
+    private static final StringProperty USERNAME = new StringProperty("username");
+    private static final StringProperty FACTOR_TYPE = new StringProperty("factorType");
+    private static final StringProperty RELAY_STATE = new StringProperty("relayState");
+
+    private static final Map<String, Property> PROPERTY_DESCRIPTORS = createPropertyDescriptorMap(USERNAME, FACTOR_TYPE, RELAY_STATE);
+
+    public DefaultOktaForgotPasswordRequest(InternalDataStore dataStore) {
+        super(dataStore);
+    }
+
+    @Override
+    public Map<String, Property> getPropertyDescriptors() {
+        return PROPERTY_DESCRIPTORS;
+    }
+    @Override
+    public String getUsername() {
+        return getString(USERNAME);
+    }
+
+    @Override
+    public OktaForgotPasswordRequest setUsername(String username) {
+        setProperty(USERNAME, username);
+        return this;
+    }
+
+    @Override
+    public String getFactorType() {
+        return getString(FACTOR_TYPE);
+    }
+
+    @Override
+    public OktaForgotPasswordRequest setFactorType(String factorType) {
+        setProperty(FACTOR_TYPE, factorType);
+        return this;
+    }
+
+    @Override
+    public String getRelayState() {
+        return getString(RELAY_STATE);
+    }
+
+    @Override
+    public OktaForgotPasswordRequest setRelayState(String relayState) {
+        setProperty(RELAY_STATE, relayState);
+        return this;
+    }
+}

impl/src/main/java/com/stormpath/sdk/impl/application/okta/DefaultOktaForgotPasswordResult.java

@@ -0,0 +1,62 @@
+package com.stormpath.sdk.impl.application.okta;
+
+import com.stormpath.sdk.application.okta.OktaForgotPasswordResult;
+import com.stormpath.sdk.impl.ds.InternalDataStore;
+import com.stormpath.sdk.impl.resource.AbstractInstanceResource;
+import com.stormpath.sdk.impl.resource.Property;
+import com.stormpath.sdk.impl.resource.StringProperty;
+
+import java.util.Map;
+
+/**
+ *
+ */
+public class DefaultOktaForgotPasswordResult extends AbstractInstanceResource implements OktaForgotPasswordResult {
+
+    private static final StringProperty STATUS = new StringProperty("status");
+    private static final StringProperty FACTOR_RESULT = new StringProperty("factorResult");
+    private static final StringProperty FACTOR_TYPE = new StringProperty("factorType");
+    private static final StringProperty RELAY_STATE = new StringProperty("relayState");
+    private static final StringProperty RECOVERY_TYPE = new StringProperty("recoveryType");
+
+    private static final Map<String, Property> PROPERTY_DESCRIPTORS = createPropertyDescriptorMap(STATUS, FACTOR_TYPE, RELAY_STATE, FACTOR_RESULT, RECOVERY_TYPE);
+
+    public DefaultOktaForgotPasswordResult(InternalDataStore dataStore) {
+        super(dataStore);
+    }
+
+    public DefaultOktaForgotPasswordResult(InternalDataStore dataStore, Map<String, Object> properties) {
+        super(dataStore, properties);
+    }
+
+
+    @Override
+    public Map<String, Property> getPropertyDescriptors() {
+        return PROPERTY_DESCRIPTORS;
+    }
+
+    @Override
+    public String getStatus() {
+        return getString(STATUS);
+    }
+
+    @Override
+    public String getFactorResult() {
+        return getString(FACTOR_RESULT);
+    }
+
+    @Override
+    public String getRelayState() {
+        return getString(RELAY_STATE);
+    }
+
+    @Override
+    public String getFactorType() {
+        return getString(FACTOR_TYPE);
+    }
+
+    @Override
+    public String getRecoveryType() {
+        return getString(RECOVERY_TYPE);
+    }
+}

impl/src/main/java/com/stormpath/sdk/impl/application/okta/OktaApplication.java

@@ -16,6 +16,8 @@
 import com.stormpath.sdk.application.ApplicationOptions;
 import com.stormpath.sdk.application.ApplicationStatus;
 import com.stormpath.sdk.application.OAuthApplication;
+import com.stormpath.sdk.application.okta.OktaForgotPasswordRequest;
+import com.stormpath.sdk.application.okta.OktaForgotPasswordResult;
 import com.stormpath.sdk.application.webconfig.ApplicationWebConfig;
 import com.stormpath.sdk.application.webconfig.ApplicationWebConfigStatus;
 import com.stormpath.sdk.application.webconfig.ChangePasswordConfig;
@@ -51,6 +53,7 @@
 import com.stormpath.sdk.impl.oauth.DefaultOAuthStormpathFactorChallengeGrantRequestAuthenticator;
 import com.stormpath.sdk.impl.oauth.DefaultOAuthStormpathSocialGrantRequestAuthenticator;
 import com.stormpath.sdk.impl.oauth.DefaultOAuthTokenRevocator;
+import com.stormpath.sdk.impl.okta.OktaApiPaths;
 import com.stormpath.sdk.impl.resource.AbstractCollectionResource;
 import com.stormpath.sdk.impl.resource.AbstractResource;
 import com.stormpath.sdk.impl.resource.Property;
@@ -231,7 +234,16 @@ public Tenant getTenant() {
 
     @Override
     public PasswordResetToken sendPasswordResetEmail(String email) throws ResourceException {
-        throw new UnsupportedOperationException("sendPasswordResetEmail() method hasn't been implemented.");
+
+        OktaForgotPasswordRequest request = getDataStore().instantiate(OktaForgotPasswordRequest.class);
+        request.setUsername(email);
+        request.setFactorType("EMAIL");
+        request.setRelayState("/");
+
+        OktaForgotPasswordResult result = getDataStore().create(OktaApiPaths.PASSWORD_RECOVERY, request, OktaForgotPasswordResult.class);
+
+        return null;
+
     }
 
     @Override

impl/src/main/java/com/stormpath/sdk/impl/okta/OktaApiPaths.java

@@ -5,9 +5,11 @@
  */
 public final class OktaApiPaths {
 
-    public final static String API_V1 = "/api/v1/";
+    public static final String API_V1 = "/api/v1/";
 
-    public final static String USERS = "/api/v1/users/";
+    public static final String USERS = API_V1 + "users/";
+
+    public static final String PASSWORD_RECOVERY = API_V1 + "authn/recovery/password";
 
     public static String apiPath(String resource) {
         return API_V1 + resource;