Add Functionality of OTP to support user 2fa

src/main/java/org/kohsuke/github/GitHub.java

@@ -671,7 +671,26 @@ public GHAuthorization createToken(Collection<String> scope, String note, String
 
         return requester.method("POST").to("/authorizations", GHAuthorization.class).wrap(this);
     }
-
+    /**
+     * Creates a new authorization using an OTP.
+     * 
+     * Start by running createToken, if exception is thrown, prompt for OTP from user
+     * 
+     * Once OTP is received, call this token request
+     *
+     * The token created can be then used for {@link GitHub#connectUsingOAuth(String)} in the future.
+     *
+     * @see <a href="http://developer.github.com/v3/oauth/#create-a-new-authorization">Documentation</a>
+     */
+    public GHAuthorization createTokenOtp(Collection<String> scope, String note, String noteUrl, String OTP) throws IOException{
+        Requester requester = new Requester(this)
+                .with("scopes", scope)
+                .with("note", note)
+                .with("note_url", noteUrl);
+        // Add the OTP from the user
+        requester.setHeader("x-github-otp", OTP);
+        return requester.method("POST").to("/authorizations", GHAuthorization.class).wrap(this);
+    }
     /**
      * @see <a href="https://developer.github.com/v3/oauth_authorizations/#get-or-create-an-authorization-for-a-specific-app">docs</a>
      */

src/test/java/org/kohsuke/github/Github2faTest.java

@@ -0,0 +1,52 @@
+package org.kohsuke.github;
+
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.text.DateFormat;
+import java.text.SimpleDateFormat;
+import java.util.Arrays;
+import java.util.Date;
+import java.util.List;
+
+import org.junit.Test;
+public class Github2faTest  extends AbstractGitHubWireMockTest {
+	public String twoFactorAuthCodePrompt() {
+		System.out.print("Github 2 factor temp key: ");
+		// create a scanner so we can read the command-line input
+		BufferedReader buf = new BufferedReader(new InputStreamReader(System.in));
+		// TODO Auto-generated method stub
+		try {
+			return buf.readLine().trim();
+		} catch (IOException e) {
+			return null;
+		}
+	}
+	@Test
+	public void test2faToken() {
+		DateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd_HH-mm-ss");
+		String timestamp = dateFormat.format(new Date());
+		List<String> asList = Arrays.asList("repo", "gist", "write:packages", "read:packages", "delete:packages",
+				"user", "delete_repo");
+		String string = "Test2faTokenCreate-" + timestamp;// use time stamp to ensure the token creations do not collide with older tokens
+		GHAuthorization token=null;
+		try {
+			token = gitHub.createToken(asList, string, "this is a test token created by a unit test");
+		}catch (IOException ex) {
+			// under 2fa mode this exception is expected, and is necessary
+			// as the exception is called, GitHub will generate and send an OTP to the users SMS
+			// we will prompt at the command line for the users 2fa code 
+			try {
+				//token = gitHub.createTokenOtp(asList, string, "", twoFactorAuthCodePrompt());// prompt at command line for 2fa OTP code
+			} catch (Exception e) {
+				e.printStackTrace();
+				fail();
+			}
+		}
+		assert token!=null;
+
+		String p = token.getToken();
+
+		assert p!=null;
+	}
+}