Anotações para assegurar aplicativos Java EE

É possível fornecer segurança para seu aplicativo corporativo Java™ EE diretamente em seu código-fonte, utilizandoanotações.

Anotações de segurança comuns : O JSR 250 define uma variedade de anotações de segurança comuns. A seguir, são definidas cinco dessas anotações:
  • javax.annotation.security.PermitAll:
    • Pode ser utilizada no nível de tipo ou de método.
    • Indica que determinado método ou que todos os métodos de negócios do EJB são acessíveis por todos.
  • javax.annotation.security.DenyAll:
    • Pode ser utilizada no nível de método.
    • Indica que determinado método do EJB não pode ser acessado por todos.
  • javax.annotation.security.RolesAllowed:
    • Pode ser utilizada no nível de tipo ou de método.
    • Indica que determinado método ou que todos os métodos de negócios no EJB podem ser acessados por usuários que estão associados à lista de funções.
  • javax.annotation.security.DeclareRoles:
    • Pode ser utilizada no nível de tipo.
    • Define as funções de verificação de segurança. A ser utilizada por EJBContext.isCallerInRole, HttpServletRequest.isUserInRole e WebServiceContext.isUserInRole.
  • javax.annotation.security.RunAs:
    • Pode ser utilizada no nível de tipo.
    • Especifica a função RunAs para os componentes fornecidos.

Utilizando anotações de segurança.

  • Para as anotações @PermitAll, @DenyAll e @RolesAllowed, uma uma anotação de nível de classe se aplica a uma classe, e uma anotação de nível de método se aplica a um método. Uma anotação de nível de método substitui o comportamento de uma anotação de nível de classe.
    	@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;
    		}
    	}
     

    Nesse exemplo, o método hello() pode ser acessado por todos, e o método goodbye() pode ser acessado por usuários da equipe de função.

  • A anotação @DeclareRoles define uma lista de funções a serem utilizadas por um determinado componente. No ambiente do Java EE 5 ou 6, é possível consultar o recurso usando @javax.annotation.Resource e verificar se o usuário é da função fornecida chamando as APIs a seguir:
    Tabela 1. . API usada pelo componente Java EE
    Component API utilizada para verificar a função.
    EJB javax.ejb.EJBContext.isCallerInRole(role)
    Servlet javax.servlet.http.HttpServletRequest.isUserInRole(role)
    Serviço da web javax.xml.ws.WebServiceContext.isUserInRole(role)
  • As anotações @PermitAll, @DenyAll e @RolesAllowed possibilitam a implementação da maioria das decisões de autorização. Contudo, para realizar lógicas mais complicadas, utilize a anotação @DeclareRoles. Por exemplo, suponha que o método hello deva ser acessado por um usuário que esteja na função A e que não esteja na função B ao mesmo tempo. O clip de código a seguir alcança esse objetivo:
    	@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 {
    				...
    			}
    		}
    	}
     

Utilização inválida de anotações de segurança

  • Mais de um das seguintes @DenyAll, @PermitAll, @RolesAllowed não se aplica ao mesmo método. Por exemplo, a utilização a seguir não é válida:
    	@PermitAll
    	@DenyAll
    	public String test()
     
  • Duas anotações @RolesAllowed não são aplicáveis aos mesmos métodos. Por exemplo, a utilização a seguir não é válida e não pode ser compilada:
    	@RolesAllowed("team")
    	@RolesAllowed("otherteam")
    	public String hello()
    Em vez dela, utilize esta estrutura:
    	@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