From d6b70ab47bc5be26a9671dfd3a0a3dd9fa044eb4 Mon Sep 17 00:00:00 2001
From: James Moger <james.moger@gitblit.com>
Date: Mon, 20 Oct 2014 16:17:39 -0400
Subject: [PATCH] Prepare 1.6.1 release
---
src/main/java/com/gitblit/manager/IAuthenticationManager.java | 42 +++++++++++++++++++++++++++++++++++++-----
1 files changed, 37 insertions(+), 5 deletions(-)
diff --git a/src/main/java/com/gitblit/manager/IAuthenticationManager.java b/src/main/java/com/gitblit/manager/IAuthenticationManager.java
index 4f43d92..3600b32 100644
--- a/src/main/java/com/gitblit/manager/IAuthenticationManager.java
+++ b/src/main/java/com/gitblit/manager/IAuthenticationManager.java
@@ -15,13 +15,12 @@
*/
package com.gitblit.manager;
-import java.security.PublicKey;
-
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import com.gitblit.models.TeamModel;
import com.gitblit.models.UserModel;
+import com.gitblit.transport.ssh.SshKey;
public interface IAuthenticationManager extends IManager {
@@ -32,17 +31,19 @@
*
* @param httpRequest
* @return a user object or null
+ * @since 1.4.0
*/
UserModel authenticate(HttpServletRequest httpRequest);
/**
- * Authenticate a user based on a public key.
+ * Authenticate a user based on a ssh public key.
*
* @param username
* @param key
* @return a user object or null
+* * @since 1.5.0
*/
- UserModel authenticate(String username, PublicKey key);
+ UserModel authenticate(String username, SshKey key);
/**
* Authenticate a user based on HTTP request parameters.
@@ -53,6 +54,7 @@
* @param httpRequest
* @param requiresCertificate
* @return a user object or null
+ * @since 1.4.0
*/
UserModel authenticate(HttpServletRequest httpRequest, boolean requiresCertificate);
@@ -63,6 +65,7 @@
* @param username
* @param password
* @return a user object or null
+ * @since 1.4.0
*/
UserModel authenticate(String username, char[] password);
@@ -71,6 +74,7 @@
*
* @param request
* @return the Gitblit cookie for the request or null if not found
+ * @since 1.4.0
*/
String getCookie(HttpServletRequest request);
@@ -79,21 +83,45 @@
*
* @param response
* @param user
+ * @since 1.4.0
*/
+ @Deprecated
void setCookie(HttpServletResponse response, UserModel user);
+
+ /**
+ * Sets a cookie for the specified user.
+ *
+ * @param request
+ * @param response
+ * @param user
+ * @since 1.6.1
+ */
+ void setCookie(HttpServletRequest request, HttpServletResponse response, UserModel user);
/**
* Logout a user.
*
* @param user
+ * @since 1.4.0
*/
+ @Deprecated
void logout(HttpServletResponse response, UserModel user);
+
+ /**
+ * Logout a user.
+ *
+ * @param request
+ * @param response
+ * @param user
+ * @since 1.6.1
+ */
+ void logout(HttpServletRequest request, HttpServletResponse response, UserModel user);
/**
* Does the user service support changes to credentials?
*
* @return true or false
- * @since 1.0.0
+ * @since 1.4.0
*/
boolean supportsCredentialChanges(UserModel user);
@@ -102,6 +130,7 @@
*
* @param user
* @return true if the user service supports display name changes
+ * @since 1.4.0
*/
boolean supportsDisplayNameChanges(UserModel user);
@@ -110,6 +139,7 @@
*
* @param user
* @return true if the user service supports email address changes
+ * @since 1.4.0
*/
boolean supportsEmailAddressChanges(UserModel user);
@@ -118,6 +148,7 @@
*
* @param user
* @return true if the user service supports team membership changes
+ * @since 1.4.0
*/
boolean supportsTeamMembershipChanges(UserModel user);
@@ -126,6 +157,7 @@
*
* @param user
* @return true if the team memberships can be changed
+ * @since 1.4.0
*/
boolean supportsTeamMembershipChanges(TeamModel team);
--
Gitblit v1.9.1