Annotationen zum Sichern von Java EE-Anwendungen

Sie können Ihre Java™ EE-Unternehmensanwendung mithilfe von Annotationen direkt im Quellcode schützen.

Allgemeine Sicherheitsannotationen: JSR 250 definiert einige allgemeine Sicherheitsannotationen. Es sind fünf Sicherheitsannotationen definiert:
  • javax.annotation.security.PermitAll:
    • Kann auf Typ- oder Methodenebene verwendet werden.
    • Gibt an, dass alle Benutzer auf die angegebene Methode oder auf alle Geschäftsmethoden der angegebenen EJB zugreifen können.
  • javax.annotation.security.DenyAll:
    • Kann auf Methodenebene verwendet werden.
    • Gibt an, dass kein Benutzer auf die angegebene Methode in der EJB zugreifen kann.
  • javax.annotation.security.RolesAllowed:
    • Kann auf Typ- oder Methodenebene verwendet werden.
    • Gibt an, dass auf die angegebene Methode oder alle Geschäftsmethoden im EJB die Benutzer zugreifen können, die der Liste der Rollen zugeordnet sind.
  • javax.annotation.security.DeclareRoles:
    • Kann auf Typebene verwendet werden.
    • Definiert Rollen für die Sicherheitsprüfung. Muss von EJBContext.isCallerInRole, HttpServletRequest.isUserInRole und WebServiceContext.isUserInRole verwendet werden.
  • javax.annotation.security.RunAs:
    • Kann auf Typebene verwendet werden.
    • Gibt die Rolle "Ausführen als" für die angegebenen Komponenten an.

Sicherheitsannotationen verwenden

  • Für die Annotationen "@PermitAll", "@DenyAll" und "@RolesAllowed" gilt eine Annotation auf Klassenebene für eine Klasse und eine Annotation auf Methodenebene für eine Methode. Eine Annotation auf Methodenebene überschreibt das Verhalten einer Annotation auf Klassenebene.
    	@Stateless
    		@RolesAllowed("team")
    		public class TestEJB implements Test {
    		@PermitAll
    				public String hello(String msg) {
    						return "Hello, " + msg;
    		}
    
    				public String goodbye(String msg) {
    						return "Goodbye, " + msg;
    		}
    	}
     

    In diesem Beispiel können alle Benutzer auf die Methode "hello()" zugreifen, auf die Methode "goodbye()" jedoch nur Benutzer der Rolle "team".

  • Die Annotation "@DeclareRoles" definiert eine Liste von Rollen, die von einer angegebenen Komponente verwendet werden sollen. In der Java EE-Umgebung der Versionen 5 oder 6 können Sie mithilfe von @javax.annotation.Resource nach der Ressource suchen und überprüfen, ob der Benutzer die angegebene Rolle hat, indem Sie die folgenden APIs aufrufen:
    Tabelle 1. . Von der Java EE-Komponente verwendete API
    Komponente Zur Überprüfung der Rolle verwendete API
    EJB javax.ejb.EJBContext.isCallerInRole(role)
    Servlet javax.servlet.http.HttpServletRequest.isUserInRole(role)
    Web-Service javax.xml.ws.WebServiceContext.isUserInRole(role)
  • Mit den Annotationen "@PermitAll", "@DenyAll" und "@RolesAllowed" können Sie die meisten Berechtigungsentscheidungen implementieren. Wenn Sie jedoch komplexere Logik erstellen möchten, müssen Sie die Annotation "@DeclareRoles" verwenden. Auf die Methode "hello" soll z. B. ein Benutzer zugreifen können, der Rolle A hat, jedoch nicht gleichzeitig Rolle B. Dieses Ziel können Sie mit folgendem Code erreichen:
    	@Stateless
    		@DeclaresRoles({"A", "B"})
    		public class TestEJB implements Test {
    				@Resource private SessionContext sc;
    				public String hello(String msg) {
    						if (sc.isCallerInRole("A") && !sc.isCallerInRole("B")) {
    				...
    			} else {
    				...
    			}
    		}
    	}
     

Ungültige Verwendung von Sicherheitsannotationen

  • Es kann höchstens eine der Annotationen "@DenyAll", "@PermitAll" und "@RolesAllowed" auf dieselbe Methode angewendet werden. Die folgende Syntax ist beispielsweise ungültig:
    	@PermitAll
    	@DenyAll
    		public String test()
     
  • Zwei @RolesAllowed-Annotationen können nicht auf dieselben Methoden angewendet werden. Die folgende Syntax ist beispielsweise ungültig und schlägt bei der Kompilierung fehl:
    		@RolesAllowed("team")
    		@RolesAllowed("otherteam")
    		public String hello()
    Verwenden Sie stattdessen die folgende Struktur:
    		@RolesAllowed({"team", "otherteam"})
    		public String hello()
Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: csecuringejee.html