Objetos e métodos internos do Zope. Apostila

Transcrição

1 2012 Objetos e métodos internos do Zope Apostila

2 Este material é de livre uso e divulgação desde que preservada as citações de suas fontes. Apostila de Treinamento ZOPE /Plone Objetos e métodos internos do ZOPE nível 300 Apostila Curso de Zope/Plone Versão 1.6 Fevereiro de 2012 Palavras chave: Zope, Python, Plone, curso, treinamento, Objetos e métodos Internos do ZOPE. 1

3 CONTROLE DE VERSÕES Versão Data Autor(es) Alterações /01/2012 ProdutivaTI Criação do documento /02/2012 ProdutivaTI Liberação da versão /03/2012 ProdutivaTI Formatação do Documento /06/2012 Tânia Andrea Revisão do Documento 2

4 Agradecimentos Lucas Aquino, Consultor e Analista de Sistemas, Herson Rodrigues, Desenvolvedor Zope/Plone, Douglas Soares de Andrade, autor da palestra Otimizando Portais Plone, Tânia Andrea, Consultora e Analista de Sistemas. A comunidade Plone que nos ajudou a produzir este material. 3

5 Sumário SOBRE O TREINAMENTO CAPÍTULO INTRODUÇÃO ZOPE ZMI - a Interface de Gerenciamento via Web Arquitetura inicial do Zope Iniciando o Zope Acessando a ZMI Entrando no Zope Controlando o Zope com a Interface de Gerenciamento Usando a Área de Trabalho Usando a área de trabalho Entendendo Usuários no Zope Criando Usuários Adicionando um novo usuário Tornando um usuário administrador Mudando Logins Multiusuários Administrando e Monitorando o Zope O Painel de Controle Importando e Exportando Objetos Visão de Import/Export objetos Resumo Laboratório CAPÍTULO INTRODUÇÃO Técnicas de criação e gerenciamento de conteúdos Criando Objetos

6 Movendo Objetos Outras operações Desfazendo Erros Detalhes e Pegadinhas do Undo Resumo Laboratório CAPÍTULO INTRODUÇÃO Segurança através de permissões e perfis Entrando e Saindo da ZMI Autenticação e Autorização Autenticação e Gerenciamento de Usuários Criando Usuários em Pastas de Usuário Editando Usuários Definindo a Localização do Usuário Contas Especiais do Usuário Usuário Anônimo do Zope Usuário Emergencial do Zope Criando um Usuário de Emergência Autorização e Gerenciamento de Segurança Trabalhando com papéis roles Definindo papéis - roles Entendendo Papéis Locais Entendendo Permissões Definindo Políticas de Segurança Aquisição de Políticas de Segurança Padrões no Uso de Segurança Regras de Manuseio de Segurança Políticas Global e Local Delegando Controle para Gerenciadores Locais

7 Diferentes Níveis de Acesso com Papéis Controlando Acesso a Locais com Papéis Executando Controles de Segurança Fluxo de Segurança Avançado: Posse e Conteúdo Executável O Problema: Ataque do Cavalo de Tróia Gerenciamento de owners Papéis do Conteúdo Executável Laboratório CAPÍTULO INTRODUÇÃO ZPT - Zope Page Templates, a camada de apresentação Expressões TALES TAL tal:content tal:replace tal:repeat Variáveis de repetição tal:define tal:attributes tal:condition tal:omit-tag METAL metal:define-macro metal:use-macro metal:define-slot metal:fill-slot Resumo Laboratório CAPÍTULO Introdução

8 Validação e processamento de formulários Criando Formulário de Exemplo e Scripts Associados Criando Validadores Criar o formulário Criar a action Criar validator Definir os metadatas do formulário Resumo Laboratório CAPÍTULO INTRODUÇÃO Integração com bancos de dados relacionais Instalação Conexões de Banco de Dados Relacionais Oracle Sybase PostgreSQL MySQL SQLServer SQL Server é o banco de dados da Microsoft. Seu DA mxodbc foi escrito pela Egenix e tem sido bem mantido e tem licença comercial. Há também o ZODBC DA escrito pela Zope Corporation, que não tem sido bem mantido. Mais detalhes podem ser obtidos no Website da Microsoft Gadfly Usando Métodos Z SQL Chamando Métodos Z SQL Fornecendo Argumentos para Métodos Z SQL Pesquisas Dinâmicas com SQL Inserindo Argumentos com a Tag Sqlvar name type

9 optional Adquirindo Argumentos Através de Outros Objetos Resumo Laboratório CAPÍTULO INTRODUÇÃO Mecanismo de busca interno: catalogação e indexação Configurando Catálogos Definindo Índices ZCTextIndex FieldIndex KeywordIndex ExtendedPathIndex DateIndex DateRangeIndex TextIndex Definindo Metadados Buscando em Catálogos Buscando com Formulários Buscando Através do Python Buscando e Indexando Informações Buscando Índices de Texto Vocabulários Buscando Índices de Campo Buscando Índices de Data Buscando Índices de Palavra Chave Laboratório CAPÍTULO INTRODUÇÃO Python básico: a camada lógica

10 Executando programas Tipagem dinâmica Compilação e interpretação Modo interativo Ferramentas Frameworks Sintaxe Blocos Objetos Sintaxes Condicionais Repetição For While Tipos Números Texto - string Listas Tuplas Dicionários Verdadeiro, falso e nulo Funções Módulos Exceções Classes Herança simples Herança múltipla Resumo Laboratório CAPÍTULO

11 INTRODUÇÃO CMF - Content Management Framework CMF e o Zope CMF e o Zope Resumo

12 SOBRE O TREINAMENTO Este treinamento é destinado àqueles que já trabalham com ZOPE/PLONE e tem conhecimento de desenvolvimento para WEB. Sua carga horária é de 40 horas/aula. Ementa: Objetos e métodos internos do Zope ZMI - a interface de gerenciamento via Web ZPT - Zope Page Templates, a camada de apresentação Técnicas de criação e gerenciamento de conteúdos Segurança através de permissões e perfis Validação e processamento de formulários Técnicas para páginas dinâmicas Integração com bancos de dados relacionais 11

13 Mecanismo de busca interno: catalogação e indexação Python básico: a camada lógica CMF - Content Management Framework 12

14 CAPÍTULO 01 INTRODUÇÃO 13

15 ZOPE 14

16 15

17 ZMI - a Interface de Gerenciamento via Web Zope é um ambiente para a construção e gerenciamento de aplicações Web com foco no seu conteúdo. Ele interpreta os fragmentos de códigos Zope e DTML em seus templates e gera uma saída HTML compreensível para qualquer navegador Web. Ou seja, as páginas de um servidor Zope são geradas dinamicamente, no momento em que o servidor recebe o pedido do browser, mesclando esses dois componentes. Os objetos que o Zope publica na Web são escritos em linguagem Python e armazenados em seu banco de dados, orientado a objetos, o ZODB. Dessa forma, tudo o que aparece em um site Zope, como por exemplo, páginas web, imagens, links ou arquivos, são objetos e armazenados em banco de dados. O Zope é um ambiente bastante amigável e tem características muito importantes que o fazem se destacar: Mapeia e acessa objetos passados na URL do navegador, respeitando as permissões de segurança e de acesso; 16

18 Armazena as versões antigas de um objeto, o que permite desfazer alterações, controlar versões de documentos colaborativos e revisões. O Zope só interpreta códigos escritos em DTML ou ZPT. O que não estiver nesses padrões é repassado para o navegador. Isso permite que estruturas escritas em Javascript, CSS, etc, possam ser utilizadas normalmente. Pode ser usado em todas as plataformas: Unix, Linux, Mac OS e em todas as versões do Windows. 17

19 18

20 19

21 Arquitetura inicial do Zope 20

22 Iniciando o Zope Excute a operação start: $ bin/instance start O Zope começará a rodar e imprimirá informações sobre o login para o console. Você deve ver informações sobre qual é a porta de acesso do Zope. Você pode agora se logar no Zope a partir do browser. O Zope é um servidor de aplicações web. Quando o Zope é iniciado, seu servidor web inicia. Acessando a ZMI Dependendo da sua plataforma, você pode executar o Zope com diferentes comandos. Qualquer que seja sua plataforma, você pode executar o Zope tanto manual como automaticamente. Quando o Zope é executado manualmente, você simplesmente dizer ao Zope quando iniciar e quando parar. Quando o Zope é 21

23 executado automaticamente, o Zope irá iniciar e parar quando seu computador iniciar e desligar. 22

24 Entrando no Zope Para entrar no Zope você precisa de um navegador. A interface do Zope é escrita inteiramente em HTML e funciona em qualquer navegador. Para entrar na interface de administrador, aponte seu navegador para a URL de administrador do Zope. A URL de administrador é a mesma URL de acesso à instância, colocando junto /manage. Supondo que você tenha instalado o Zope em sua máquina local, rodando na porta padrão 8080, a URL de administrador é: Esta URL geralmente funciona, mas você pode precisar logar em um navegador diferente da que nós mostramos aqui. Para descobrir exatamente qual URL deve ser usada, observe as informações de login do Zope que aparecem no início. Por exemplo: Depois que você entrar com a URL de administrador no seu navegador, você fará o login no Zope com o nome do usuário e senha. Digite o nome do usuário inicial e a senha criados durante o processo de instalação. 23

25 Controlando o Zope com a Interface de Gerenciamento Após ter conseguido entrar no Zope, você vai ver uma página web da Interface de Gerenciamento do Zope. A interface de gerenciamento do Zope permite que você controle o Zope a partir do seu navegador. A interface de Gerenciamento do Zope está separada em três quadros (frames). Com o frame da esquerda você navega no Zope como se você estivesse navegando através de um sistema de arquivos com um gerenciador de arquivo como o Windows Explorer e tem alguns atalhos do que existe na íntegra na Área de Trabalho do Zope. Este frame é chamado de Navegador e fica à esquerda. Neste frame você consegue ver o diretório raiz (Root Folder) e todas as suas subpastas (subfolders). O diretório raiz está no canto superior esquerdo da árvore. Tudo que estiver no Zope vai estar dentro do diretório raiz. 24

26 Algumas das pastas possuem o sinal de adição (+) a sua esquerda. Estas marcas indicam que você pode expandir as pastas (folders) para ver as subpastas que estão dentro delas. Para gerenciar um folder, clique nele e ele aparecerá no frame direito, este frame é chamado de Workspace (área de trabalho). 25

27 Usando a Área de Trabalho O frame direito, da interface de gerenciamento, mostra os objetos que você está gerenciando no momento. Quando entrar pela primeira vez no Zope, o objeto corrente será o diretório raiz, como mostrado no frame direito do exemplo. A área de trabalho mostra informações sobre o objeto corrente e permite acessar suas informações. No topo da área de trabalho existem várias abas (tabs). A aba (tab) selecionada no momento está em uma cor mais clara. Cada aba leva à ações diferentes do objeto atual. Cada aba deixa que você execute uma função diferente de gerenciamento naquele objeto. No exemplo, você está olhando para a aba Contents (Conteúdos) do objeto da pasta raiz. No topo da área de trabalho, abaixo das abas, há uma descrição do tipo de objeto atual e a URL. Na esquerda há um ícone representando o tipo do objeto atual e à direita dele está a URL do objeto. 26

28 No exemplo, "Folder at /" mostra que o objeto atual é um folder e que sua URL é /, ou seja, é a raiz. Observe que esta URL é uma URL relativa do objeto para a URL base do Zope. Assim, se a URL ou o seu site Zope fossem então a URL do "Folder at /minha-pasta" seria Quando você explora diferentes objetos do Zope, você pode notar que as URLs (como mostrado na tela de gerenciamento), podem ser usadas para navegar nos objetos já percorridos. Este recurso se chama migalhas de pão ou breadcrumb e é muito utilizado em portais para ajudar na orientação do usuário ao navegar nas páginas do site. Por exemplo, se você está administrando um folder em /loja/departamento/perfumes você pode retornar ao folder em /loja dando um clique na palavra loja na URL da ZMI. No frame de nome Topo, acima da árvore de diretórios e área de trabalho, o Zope mostra informações do login atual, que no exemplo o usuário logado é o "admin" (administrador), junto com um menu de seleção que permite a você selecionar: Preferências (Set Preferences) Aqui, você pode ajustar as preferências padrões para a sua seção do Zope, você pode até esconder o frame do topo. Sair (Logout) Selecionando este item do menu você será deslogado do Zope. 27

29 Usando a área de trabalho 28

30 Entendendo Usuários no Zope O Zope é um sistema multiusuário. Você já viu como você pode logar no Zope através da interface de gerenciamento com o nome do usuário inicial e a senha. O Zope suporta outros tipos de usuários: Emergency User (Usuário de Emergência) O usuário de emergência é raramente usado no Zope. Esta conta é usada para criar outras contas de usuários e consertar as coisas se você acidentalmente ficar impedido de acessar a ZMI. O usuário de emergência é ao mesmo tempo muito poderoso e muito fraco. Ele não é restringido pela maioria dos controles de segurança. Porém, o usuário de emergência só pode criar um tipo de objeto: Users (Usuários). Manager (Administrador) O administrador é quem mais trabalha no Zope. Você precisa estar logado como administrador para fazer a maioria do trabalho envolvido no gerenciamento da 29

31 instância. O usuário inicial é um administrador e você pode criar tantas contas de administrador quantas você precisar. Outros Você pode criar seus próprios tipos de usuários que se encaixam em papéis (roles) existentes ou que você definiu. Isto será explicado no capítulo que trata da segurança e usuário do Zope. 30

32 Criando Usuários Administradores podem criar usuários no Zope em um único tipo de folder chamado User Folder (Pasta de Usuário). O ícone do user folder parece-se com os folders com o desenho de uma pessoa neles. Os user folders sempre têm o nome acl_users. Clique no folder acl_users no diretório raiz para entrar na pasta de usuário existente. Folders de Usuários contêm objetos Usuário (users). Você pode criar novos usuários e editar os existentes. Clique no item Users para criar um novo usuário, como mostrado no exemplo: Adicionando um novo usuário Dentro de Users, clique no link Add a user e preencha o formulário para criar um novo usuário. Nos campos User ID e Login Name coloque o nome do usuário escolhido, lembrando, sem caracteres especiais. Escolha uma senha e coloque-a nos campos Password e Confirm Password e então clique no botão Add User. 31

33 Tornando um usuário administrador Para tornar um usuário administrador, retorne a pasta de usuários (acl_users), clique no item Roles. Como mostra a figura abaixo: Dentro de Roles, clique no link Add a role e clique na interrogação da coluna Assignments para então adicionar um usuário ao papel. No campo Principal ID digite o id completo ou parcial do usuário a se considerado um administrador e clique no botão Search (buscar). Selecione os usuários desejados na coluna Available (usuários disponíveis) e pressione a seta da direita. Parabéns você acaba de criar uma conta de administrador. O Zope mostrará a você esta nova conta de administrador dentro do user folder, coluna Active (usuários ativos). Se desejar mais tarde você pode alterar a conta do usuário, alterar sua permissão ou excluir este usuário. 32

34 Mudando Logins Para trocar o usuário logado, selecione Logout no topo do frame da interface de gerenciamento. Você estará pronto para logar novamente. Entre com o novo nome de usuário e senha. Para sair da sessão selecione Logout no topo do frame da interface de gerenciamento e cancele o novo login. Você deverá ver uma mensagem dizendo que você está deslogado. Se você tentar acessar a interface de gerenciamento do Zope depois de ter saído, você terá que logar novamente. Você também pode sair do Zope fechando o seu navegador. 33

35 Multiusuários 34

36 Administrando e Monitorando o Zope O Control Panel (Painel de Controle) é um objeto no diretório raiz que controla alguns aspectos operacionais do Zope. Clique no objeto Control_Panel do diretório raiz, como mostra a figura. O Painel de Controle Para parar o Zope, clique no botão Shutdown. Parando o Zope fará com que o servidor pare de controlar as solicitações e saia completamente da memória. Você terá que iniciar o Zope manualmente para continuar usando-o. Somente feche o Zope se você tiver terminado de usá-lo, e terá capacidade de acessar o servidor no qual o Zope está rodando, de forma que você possa reiniciá-lo depois. Se você estiver executando o Zope no UNIX sob o controle de um daemon, bin/instance start, por exemplo, ou como um serviço no Windows, você pode reiniciar o Zope a partir da pasta Painel de Controle. Clicando no botão Restart o Zope será fechado e imediatamente iniciará uma nova instância do servidor do 35

37 Zope. Pode levar alguns segundos para que o Zope volte e inicie o controle das solicitações. No painel de controle você também verá muitos links na parte inferior da tela, um deles é o Database Management (Gerenciamento do Banco de Dados), que controla o banco de dados de objetos do Zope - ZODB. As transações não são removidas até que você dê um pack no banco de dados do Zope. Isto significa que você pode desfazer todas as transações exceto aquelas que já foram removidas por um pack no banco de dados. Quando você escolhe dar um pack no banco de dados você pode especificar que tempo de transações poupar. Como exemplo e é recomendado, somente remover as transações mais velhas que uma semana, junto com uma rotina eficaz de backup da base de dados. 36

38 Importando e Exportando Objetos Você pode mover objetos de um sistema do Zope para outro usando export e import. Você pode exportar todos os tipos de objetos do Zope para um arquivo de exportação que possui a extensão.zexp. Este arquivo pode ser importado então para dentro de qualquer outro sistema do Zope. Você pode pensar em exportar um objeto como clonar um pedaço de seu sistema Zope para um arquivo que você pode mover de máquina para máquina. Pegando este arquivo você pode montar o clone em qualquer outro servidor Zope, desde que as versões do Zope e seus produtos sejam as mesmas. Imagine que você tenha alguns documentos em uma pasta do Zope. Se você quisesse copiar apenas esses objetos para o sistema Zope de seu amigo, você poderia exportar a pasta e enviar o arquivo de exportação por ao amigo e que poderia importá-lo na sua máquina. Suponhamos que você tenha uma pasta para tarefa de casa (homework) que você queira exportar de seu servidor Zope na escola, e levar para casa e para trabalhar no servidor Zope local. Você pode criar uma pasta como esta em seu diretório raiz 37

39 chamada "homework". Vá para a pasta que contém sua pasta homework. Selecione a pasta homework marcando a checkbox próximo à ela. Então clique no botão Import/Export. Você deve agora estar trabalhando na tela da pasta Import/Export. Visão de Import/Export objetos Há duas sessões para esta tela. A metade de cima é a sessão de exportação e a metade de baixo é a sessão de importação. Para exportar um objeto desta tela, digite o id do objeto dentro do primeiro campo do elemento, Export object id. Em nosso caso o Zope já preencheu este campo para nós, considerando que nós marcamos o folder homework na tela anterior e clicamos no botão Import/Export. A próxima opção do formulário deixa você escolher entre fazer o download do arquivo de exportação para seu computador ou deixá-lo no servidor. Se você selecionar Download to local machine, e clicar no botão Export, seu browser estará pronto para fazer o download do arquivo de exportação. Se você selecionar Save to file on server, então o Zope salvará o arquivo na mesma máquina na qual o Zope está rodando, a pasta de destino será listada junto com a mensagem de sucesso e você mesmo deve trazer o arquivo daquele local. O arquivo de exportação será salvo no diretório var do Zope em seu servidor. Por padrão os arquivos exportados têm a extensão.zexp, como citado anteriormente. Em geral é mais útil baixar o arquivo de exportação para a sua máquina local. Às vezes é mais conveniente salvar no servidor se, por exemplo, você estiver em uma conexão lenta e o arquivo de exportação for muito grande, ou se você estiver apenas tentando mover o objeto exportado para outra instância do Zope no mesmo computador. O elemento final do formulário de exportação é a caixa de seleção XML format?. Selecionando esta caixa exportamos o objeto no formato extensible Markup Language (XML). Não selecionando esta caixa exportamos o arquivo no formato binário do Zope. O formato XML é muito maior para baixar, mas é legível e analisável. Em geral você deveria deixar esta caixa não selecionada a menos que você esteja curioso em saber como o arquivo gerado no formato XML será. Clique o botão Export e salve seu arquivo de exportação homework.zexp Agora, se supõe que você já foi para casa e quer importar o arquivo no servidor Zope da sua casa. Primeiro você deve copiar o arquivo de exportação no diretório import do Zope em seu servidor. Agora, vá para a tela Import/Export da pasta onde você quer executar a importação. Selecione o nome do arquivo de exportação no campo Import File name e clique no botão Import para importar esses objetos no Zope. 38

40 O Zope lhe dá opção ou para Take ownership of imported objects ou para Retain existing ownership information. Ownership (propriedade) por enquanto não entraremos em detalhes. Agora, deixe a opção Take ownership of imported objects selecionada. Depois que você importar o arquivo você deve ver um novo objeto na pasta do Zope onde você executou a importação. Observe que você não pode importar um objeto em uma pasta que tem um objeto com o mesmo id. Então, quando você levar a sua lição de casa para a escola, você precisará importá-la dentro de uma pasta que não tem uma pasta homework no contexto. Então, você precisará apagar sua pasta antiga homework e copiar a pasta mais recente em seu lugar. 39

41 Resumo Zope é um ambiente para a construção e gerenciamento de aplicações Web com foco no seu conteúdo facilitando a manutenção dos portais desenvolvidos. Os objetos tem a funcionalidade de gerenciamento, além de importar e exportar esses objetos. 40

42 Laboratório 41

43 CAPÍTULO 02 INTRODUÇÃO 42

44 Técnicas de criação e gerenciamento de conteúdos 43

45 Criando Objetos A interface de gerenciamento do Zope representa tudo em termos de objetos e folders. Quando você constrói aplicações para a Web com o Zope, você gasta a maioria do seu tempo criando e gerenciando objetos nos folders. Por exemplo, para fazer uma nova conta de administrador você cria um objeto usuário em um user folder. Retorne ao diretório raiz clicando no topo do lado esquerdo no frame de Navegação. Para adicionar um novo objeto ao folder corrente, selecione um objeto do menu de seleção no frame a direita chamado "Select type to add..." (Selecione o tipo a ser adicionado). Este menu tem a lista para adição de itens. Por exemplo, para criar uma pasta, selecione Folder da lista de adição. Neste ponto, será mostrado um formulário de adição que coleta informações sobre o novo folder, como mostra o exemplo: 44

46 Digite "zoo" no campo Id, e o "Zoológico" no campo Title. Então clique no botão Add. O Zope criará uma nova pasta dentro da pasta atual. Você pode verificar isto observando que há um novo folder chamado zoo dentro do diretório raiz. Clique no zoo para entrar nele. Observe que a URL da pasta é baseada no ID da pasta criada. Você pode criar mais pastas dentro da sua nova pasta se quiser. Por exemplo, crie uma pasta dentro da pasta zoo com um id mamíferos. Vá à pasta zoo e escolha Folder do menu de opções. Então digite "mamíferos" no ID do folder, e "Mamíferos" para o título. Agora clique no botão Add. Você sempre cria novos objetos da mesma maneira: 1. Vá até o folder onde você quer adicionar um novo objeto. 2. Escolha o tipo de objeto que você quer adicionar do menu. 3. Preencha um formulário de adição e clique no botão de enviar. 4. O Zope criará o novo objeto dentro do folder corrente. Note que todo o objeto do Zope tem um id que você precisa especificar no formulário de adição, quando você cria o objeto. O id é como o Zope chama os objetos. Os objetos também usam seus ids para suas respectivas URLs. 45

47 Movendo Objetos A maioria dos sistemas de computador deixa você mover arquivos de um diretório para outro com as funções recortar, copiar e colar. A interface de gerenciamento do Zope possui um sistema similar que deixa você mover os objetos pelas pastas, recortando ou copiando-os, e então os colando em um novo lugar. Para experimentar como é a função recortar e colar, crie uma nova pasta no diretório raiz com um id felinos. Suba um nível na hierarquia de pasta e selecione felinos marcando o check box na esquerda do folder. Clique no botão Cut. O cut (recortar) remove os objetos selecionados da pasta e os armazena temporariamente na memória (clipboard). O objeto não irá, no entanto, desaparecer da pasta de origem até que ele seja colado em outro lugar. Agora, entre na pasta zoo clicando nela, e então na pasta mamíferos clicando nela também. Você também poderia ter usado o navegador para chegar a este mesmo local. Agora, clique no botão Paste para colar o(s) objeto(s) recortado(s) na pasta especificada. Você deve ver a pasta felinos aparecer no novo local. Você pode 46

48 verificar que o folder foi removido, indo ao diretório raiz e observando que a pasta felinos não está mais lá. 47

49 Outras operações O Copy (copiar) tem função semelhante ao recortar. Porém, quando você cola objetos copiados, os objetos originais não são mudados. Selecione o(s) objeto(s) que você quer copiar e clique no botão Copy. Então navegue até a outra pasta e clique no botão Paste. Você pode recortar e colar pastas que contenham outros objetos e mover muitos objetos ao mesmo tempo com um único recortar e colar. Por exemplo, vá à pasta zoo e copie a pasta mamíferos. Agora a cole dentro da pasta zoo. Agora você terá duas pastas dentro da pasta zoo, mamíferos e copy_of_mamíferos. Se você colar um objeto no mesmo folder que você o copiou, o Zope mudará o id do objeto colado. Este é um passo necessário, pois você não pode ter dois objetos com o mesmo id no mesmo folder. Para renomear a pasta Copy of mamíferos, selecione a pasta marcando o check box à esquerda desta pasta. Então clique no botão Rename (renomear). Isto mostrará um formulário de renomeação. Digite um novo id "novo-zoo" e clique em OK. Os ids do Zope podem ter letras, números, espaços, separações com sublinhas (underscores) e pontos, e são sensíveis ao contexto (case-sensitive). Aqui estão alguns ids válidos do Zope: index.html, 42, Snake-Pit Agora sua pasta zoo contém as pastas mamíferos e novo-zoo. Cada uma delas contém uma pasta felinos. Isto é porque quando fizemos uma cópia da pasta mamíferos também foi copiada a pasta felinos que está contida nela. Se você quiser excluir um objeto, selecione-o e então clique no botão Delete. Diferente de objetos cortados, os objetos excluídos não são postos temporariamente na memória e não podem ser colados. Na próxima sessão veremos como podemos recuperar objetos deletados. O Zope não permite que você recorte, exclua ou renomeie alguns objetos particulares do diretório raiz. Esses objetos incluem Control_Panel, standard_html_header, standard_html_footer, e standard_error_message. Eles são necessários para operações do Zope. Também, estas operações não funcionarão em algumas situações. Por exemplo, você não pode colar um objeto usuário em um folder comum. Se você está tendo problemas com a cópia e colagem, certifique-se de que você tenha ativado os cookies no seu browser. O Zope usa os cookies para manter um rastro dos objetos que você cortou e copiou. 48

50 Desfazendo Erros Qualquer ação no Zope que cause mudança no objeto pode ser desfeita. Pela aba Undo. Você pode recuperar, desfazendo os erros. Selecione a pasta Zoo que nós criamos anteriormente e clique no botão Delete. A pasta desaparece. Você pode voltar desfazendo a ação de excluir. Selecione a primeira transação rotulada /manage_delobjects, e clique no botão Undo. Esta ação diz para o Zope desfazer a última transação. Você pode verificar que a tarefa foi realizada vendo que a pasta zoo retornou. Detalhes e Pegadinhas do Undo O Undo funciona no banco de dados objeto que o Zope usa para armazenar todos os seus objetos. Mudanças no banco de dados orientado a objetos acontecem em transações. Você pode pensar em transação como quaisquer mudanças que você faça no Zope, tais como criar um folder ou colar muitos objetos em um novo lugar. 49

51 Cada transação descreve todas as mudanças que aconteceram ao executar uma ação. Você não pode desfazer uma transação se esta transação depender de uma transação anterior. Por exemplo, se você cola um objeto em uma pasta e então apaga um objeto na mesma pasta, você pode querer saber se você pode ou não desfazer a colagem anterior. Ambas as transações mudam o mesmo folder assim você não pode simplesmente desfazer a primeira transação. A solução é desfazer ambas as transações. Você pode desfazer mais de uma transação ao mesmo tempo selecionando múltiplas transações na aba Undo e clicando em Undo. Outra observação com relação ao desfazer. Somente mudanças nos objetos armazenados no banco de dados objeto do Zope podem ser desfeitas. 50

52 Resumo O gerenciamento dos objetos no Zope é representado em objetos e folders. Quando é desenvolvida as aplicações para a web com o Zope, você gasta a maioria do seu tempo criando e gerenciando objetos nos folders. 51

53 Laboratório 52

54 CAPÍTULO 03 INTRODUÇÃO 53

55 Segurança através de permissões e perfis Neste capítulo iremos estudar como o Zope administra os usuários, autenticação, autorização, através de permissões e perfis. Todas as aplicações para web precisam administrar a segurança. Administrar a segurança significa controlar quem pode acessar sua aplicação e determinar o que cada um pode fazer. Segurança não é uma questão que pode ser adicionada para proteger o sistema. Pelo contrário, segurança deve ser um importante elemento do projeto que você deve levar em conta quando constrói suas aplicações em Zope. Nesse capítulo você descobrirá como criar e administrar contas de usuários, e como controlar a maneira que os usuários utilizam sua aplicação, criando políticas de segurança. Segurança no Zope controla o que os usuários do seu site podem fazer e como você e os outros podem manter seu site. Se você considerar cuidadosamente a segurança você pode oferecer poderosos recursos para seus usuários e permitir que um grande grupo de pessoas trabalhe conjuntamente, com segurança, para manter seu site. Se você não levar isso em conta, será difícil proporcionar aos seus usuários um controle seguro e administrar seu site se tornará uma pesada e 54

56 desorganizada tarefa. Seu site sofrerá não somente com as coisas erradas que as pessoas normalmente não teriam intenção de fazer, mas será difícil para você fornecer valor aos seus usuários e controle aos que administram seu site. Zope entrelaça a segurança em quase todos aspectos da construção de aplicativos para Web. Zope utiliza o mesmo sistema de segurança para controlar o gerenciamento do Zope que você costuma usar para criar usuários para sua aplicação. O Zope não faz distinção entre usar e gerenciar a aplicação. Isso pode parecer confuso, mas na realidade isso permite que você possa melhorar o sistema de segurança do Zope para as necessidades da sua aplicação. 55

57 Entrando e Saindo da ZMI Como vimos em capítulo anterior, você loga no Zope através da URL de gerenciamento no seu navegador e digitando seu nome de usuário e senha. E para deslogar da aplicação temos dois caminhos, clicar em logoff ou fechar e limpar os cookies do navegador. Se você tentar acessar um recurso protegido para o qual você não tem os privilégios de acesso, o Zope emitirá um aviso para logar. Isto pode acontecer mesmo se você já estiver logado. Em geral, não há necessidade de logar no Zope se você apenas necessita utilizar os recursos publicados. 56

58 Autenticação e Autorização Segurança no sentido amplo, controla duas funções, autenticação e autorização. Autenticação significa descobrir quem você é e a autorização significa determinar o que você pode fazer. O Zope oferece facilidades separadas para gerenciar o processo de reconhecimento de usuários e concessão de acesso a áreas controladas. Quando você acessa recursos protegidos (por exemplo, visualizando uma página privada) o Zope pedirá que você logue e procurará por sua conta de usuário. Este é o processo de autenticação. Note que o Zope apenas autenticará você caso você queira acessar um recurso protegido, se você apenas acessar recursos públicos o Zope continuará assumindo que você é um usuário anônimo. Uma vez autenticado, o Zope determina se você deve ou não ter acesso ao recurso protegido. Este processo envolve duas camadas intermediárias entre você e o recurso protegido, roles (papéis) e permissões. Usuários possuem papéis que descrevem o que podem fazer como "Owner" ou "Manager". Os objetos do Zope 57

59 têm permissões que descrevem o que pode ser feito como, por exemplo "Visualizar", "Apagar objetos" e "Gerenciar propriedades". Políticas de segurança mapeiam os papéis para permissões. Em outras palavras, eles determinam quem pode fazer o que. Por exemplo, uma política de segurança pode associar o papel "Manager" com a permissão "Apagar objetos". Isso permite que os administradores apaguem objetos. Neste caso, o Zope autoriza um usuário a executar ações protegidas. Nas seguintes sessões examinaremos mais de perto a autenticação e a autorização e como efetivamente aplicar as políticas de segurança. Primeiro você aprenderá sobre a autenticação utilizando usuários e User Folders, e depois descobrirá como controlar a autorização com as políticas de segurança. Autenticação e Gerenciamento de Usuários Um usuário Zope define uma conta de usuário. Um usuário Zope tem um nome, uma senha, e opcionalmente, dados adicionais sobre quem utiliza o Zope. Para logar no Zope, você deve ter uma conta de usuário. Vamos examinar como criar e gerenciar contas de usuários. 58

60 Criando Usuários em Pastas de Usuário Para criar contas de usuários no Zope você adiciona usuários aos User Folders (Diretórios de Usuários). No Capítulo anterior, você deve já ter adicionado um usuário no nível superior do seu diretório de usuário. Vamos criar um novo usuário para que seu colega possa ajudá-lo a administrar o seu site no Zope. Vá para a pasta raiz, no caso homework. Crie um novo User Folder dentro desta pasta. Clique no User Folder chamado acl_users. O User Folder contém objetos usuários do Zope. Entre em acl_users e clique no botão Add... para criar um novo usuário. O formulário do slide permite que você defina o usuário. Digite um nome do usuário para o seu colega no campo Name por exemplo, "usuarioadm". O nome do usuário pode conter letras, espaços e números. O nome do usuário é case sensitive (sensível ao contexto). 59

61 Escolha uma senha para seu colega e digite-a nos campos Password e Confirm. Definiremos as coisas de tal maneira que o seu colega poderá mudar a sua senha mais tarde quando logar. O campo Domains possibilita que você restrinja domínios da Internet nos quais o usuário pode logar. Isto lhe possibilita adicionar outro controle de segurança para sua conta. Por exemplo, se você deseja que seu colega sempre logue do trabalho você poderá entrar com o seu domínio do trabalho, por exemplo "escritorio.com", no campo Domains. Você pode especificar múltiplos domínios separados por espaços para permitir aos usuários logar de vários domínios. Por exemplo, se você decide que seu colega deve ser capaz de gerenciar o Zope do domínio da sua casa também, você pode setar o campo domains para "escritorio.com casa.net". Você também pode usar números de IP com asteriscos para indicar os números nos quais esses endereços estão contidos, ao invés de nomes de domínios para especificar domínios. Por exemplo, " *" englobará todos os endereços IP que começam com " ". A lista de seleção Roles indica que papéis o usuário deverá ter. Em geral, usuários que executam tarefas de gerenciamento do Zope deveriam ter o papel Manager. No caso do seu colega, selecione o papel Manager. O papel Owner não é apropriado na maioria dos casos, porque um usuário é normalmente um proprietário de um objeto específico, não um proprietário em geral. Analisaremos a propriedade mais tarde neste capítulo. Nós também veremos mais tarde como você pode definir seus próprios papéis como Editor e Reviewer. Após preenchimento dos campos, clique no botão Add. Você deve ver um novo objeto usuário no User Folder. Editando Usuários Você pode editar usuários existentes clicando neles. Isso mostra um formulário muito similar ao formulário que você usou para criar um usuário. De fato você pode controlar as mesmas opções que acabamos de ver. Depois que seu colega logar na conta que você criou para ele, ele deve ir para esta tela de gerenciamento e mudar sua senha aqui. Como todas as funções de gerenciamento do Zope, a função editar usuários está protegida pela política de segurança. Um usuário pode apenas mudar a senha dele ou de todos, se ele tiver a permissão Manage users que os administradores têm por padrão. Mais tarde analisaremos um meio de evitar um problema em potencial. Contudo, fique tranquilo, pois não é possível alguém descobrir sua senha da interface de 60

62 gerenciamento. Outro administrador pode ter acesso para mudar sua senha, mas não pode descobrir sua senha atual, a menos que a altere. Em geral, os User Folders funcionam como pastas normais do Zope. Você pode criar, editar e apagar os objetos contidos. Porém, os User Folders não são tão poderosos como as pastas normais. Você não pode recortar e colar um usuário, nem criar nada dentro dela além de usuários. Para apagar um usuário existente no User Folder, selecione o usuário e clique no botão Delete. Lembre-se que assim como todas as outras ações no Zope, isto pode ser desfeito se você cometeu um erro. 61

63 Definindo a Localização do Usuário O Zope pode conter vários User Folders em diferentes locais na hierarquia dos objetos. Um usuário do Zope não pode acessar recursos acima do User Folder no qual ele está definido. O local onde a conta do usuário está definida determina quais recursos do Zope você pode acessar. Se sua conta estiver definida no User Folder do diretório raiz, você tem acesso à pasta raiz. É onde provavelmente a sua conta atual está definida. No entanto, você pode definir usuários em qualquer pasta do Zope. Considere o caso de um User Folder em intranet/documentos/acl_users. Suponha que o usuário Severino Silva está definido nesta pasta. Severino não pode logar no Zope acima da pasta intranet/documentos. Efetivamente, a visualização do site do Zope de Severino está limitada aos itens na pasta intranet/documentos e abaixo dela. Apesar dos papéis reservados a Severino, ele não pode acessar recursos protegidos acima da sua localização. 62

64 Utilizando essa técnica é fácil construir políticas de segurança simples. Um dos padrões de gerenciamento mais comuns do Zope é colocar determinados objetos juntos numa pasta e então criar um User Folder naquela pasta para definir os responsáveis por aqueles objetos. Por exemplo, suponha que as pessoas na sua organização usem uniformes. Você está criando uma intranet que fornece informações sobre sua organização, inclusive informações sobre os uniformes. Você poderia criar uma pasta uniformes em algum lugar no site Zope da intranet. Nessa pasta você poderia colocar objetos como fotos dos uniformes e descrições de como os vestir e limpar. Depois você poderia criar um User Folder na pasta uniformes e criar uma conta para o costureiro chefe. Quando um novo estilo de uniforme ficar pronto, o costureiro não precisará pedir ao webmaster para atualizar o site, ele(a) mesmo(a) poderá atualizar sua própria sessão do site sem incomodar ninguém. Além disso, o costureiro chefe não pode logar em nenhuma pasta acima de uniformes, o que significa que o costureiro chefe não pode gerenciar outros objetos a não ser os da pasta uniformes. Este padrão de segurança é chamado de delegação e é muito comum nas aplicações do Zope. Pela delegação de diversas áreas do seu site Zope para diferentes usuários, você pode distribuir a responsabilidade da administração do site a um pequeno grupo de administradores para diferentes grupos de usuários específicos. Mais tarde nesse capítulo analisaremos outros padrões de segurança. 63

65 Contas Especiais do Usuário O Zope oferece três contas especiais de usuários que não são definidas com diretórios de usuários, o anonymous user (usuário anônimo), o emergency user (usuário de emergência) e o initial manager (administrador inicial). O usuário anônimo é utilizado frequentemente, enquanto as contas do usuário de emergência e administrador inicial são raramente utilizadas, mas o importante é conhecer e saber. Usuário Anônimo do Zope O Zope tem embutida, uma conta de usuário para visitantes, o usuário anônimo. Se você não possui uma conta de usuário no Zope, você será considerado como um usuário anônimo. O usuário anônimo tem controle de segurança como qualquer outro, ele tem o papel Anonymous. Por default o papel Anonymous apenas pode acessar recursos públicos, e não pode modificar nenhum objeto do Zope. Você pode modificar essa política, mas a maioria das vezes você achará as configurações padrões da segurança do usuário anônimo suficientemente adequadas. 64

66 Como já mencionamos anteriormente no capítulo, você deve tentar acessar um recurso protegido para que o Zope autentique você. A conclusão é que, mesmo você possuindo uma conta de usuário, o Zope considerará você anônimo até que você se autentique. Usuário Emergencial do Zope O Zope possuia uma conta de usuário especial para uso na emergência, chamado emergency user. O usuário de emergência não era restringido pelas configurações normais de segurança. Esta conta de administrador possuia as permissões de Visualizar telas de gerenciamento (View management screens) e Mudar permissões (Change permissions). Portanto, o usuário de emergência não poderia criar novos objetos com exceção de novos objetos de usuário. O usuário de emergência era realmente útil nas seguintes ocasiões: ordenação de permissões, criação de novas contas de administrador, troca da senha de acesso ao Zope ou caso você tenha trancado a si mesmo fora do Zope por remover permissões que precisava para gerenciá-lo. Como vimos no Capítulo anterior, você poderia logar como usuário de emergência para criar a conta de administrador caso não existisse uma com mesmo nome. Depois de criada a conta de administrador você deveria deslogar como usuário de emergência e logar-se novamente como administrador. No Zope para o Plone mais novo, a versão 4 por exemplo, a conta criada via linha de comando para acessar o Zope em situações emergenciais é um administrador com permissões completas de criação de conteúdo. Esta nova conta de administrador não é mais restrita. 65

67 Criando um Usuário de Emergência Diferente da conta de usuário normal que é definida pela Web, a conta de um usuário de emergência em versões antigas do Zope era criada via sistema de arquivos a partir de um arquivo chamado access, que deveria ser apagado após criação de uma nova conta. No Zope para uso do Plone 4, um usuário pode ser criado via linha de comando, caso tenha perdido a senha da conta de acesso do seu Zope, por exemplo. O procedimento é simples. Pare o serviço do Plone, execute o comando abaixo, suba a instância novamente e logue com a nova conta. bin/instance adduser <name> <password> Se o seu buildout nomeia a(s) instância(s) de maneira diferente, você precisará ajustar o comando para funcionar. Exemplo: bin/client1 adduser <name> <password> Até aqui nós mostramos como usuário e diretórios de usuários controlam a autenticação. Depois veremos como controlar autorização com as políticas de segurança. 66

68 Autorização e Gerenciamento de Segurança As políticas de segurança do Zope controlam a autorização, elas definem quem pode fazer o que. Políticas de segurança descrevem os papéis e suas respectivas permissões. Papéis identificam classes de usuários, e as permissões protegem objetos. Assim, políticas de segurança definem quais classes de usuários (papéis) podem tomar quais tipos de ações (permissões) numa dada parte do site. Mais do que afirmar qual usuário específico pode tomar qual ação específica em qual objeto específico, o Zope lhe permite definir quais tipos de usuários podem tomar quais tipos de ação em quais áreas do site. Esse tipo de generalização torna suas políticas de segurança mais simples e mais poderosas. É claro que você pode fazer exceções às suas políticas para usuários específicos, ações e objetos. Nas seções seguintes nós examinaremos mais de perto papéis, permissões a políticas de segurança com a visão de construir políticas de segurança simples e eficazes. 67

69 Trabalhando com papéis roles Os usuários do Zope possuem papéis (roles) que definem que tipos de ações eles podem tomar. Os papéis definem classes de usuários como Manager, Anonymous, e Authenticated. Papéis são parecidos com grupos UNIX em que eles abstraem grupos de usuários. E como grupos UNIX, usuários Zope têm mais de um papel. Papéis facilitam o gerenciamento da segurança. Ao invés de definir o que cada usuário pode fazer, você pode simplesmente aplicar algumas políticas de segurança para diferentes papéis de usuários. O Zope vem com quatro papéis embutidos: Manager (Administrador) Esse papel é usado para usuários que executam funções padrões de gerenciamento do Zope, como criar e editar pastas e documentos do Zope. 68

70 Anonymous (Anônimo) O Usuário Anônimo do Zope tem esse papel. Esse papel deve ser autorizado para visualizar recursos públicos. Em geral, ele não deve ter permissão para modificar objetos do Zope. Owner (Proprietário) Esse papel é associado automaticamente aos usuários no contexto em que os objetos são criados. Falaremos de posse posteriormente neste capítulo. Authenticated (Autenticado) Essa função é associada automaticamente aos usuários que possuem credenciais de autenticação válidas. Essa função significa que o Zope "sabe" particularmente quem é o usuário. Para sites básicos do Zope você pode usar os papéis Manager e Anonymous. Para sites mais complexos você pode criar seus próprios papéis para classificar seus usuários em categorias diferentes. Definindo papéis - roles Para criar um novo papel vá para a aba Security e role a barra de rolagem para baixo até o fim da tela. Digite o nome do novo papel no campo User defined roles e clique no botão Add Role. Nomes de papéis devem ser curtos, descrição em uma ou duas palavras do tipo de usuário como "Author", "Site Architect", ou "Designer". Você deve escolher os nomes relevantes para os papéis da sua aplicação. Você pode verificar que seu papel foi criado, percebendo que há uma nova coluna para ele, no topo da tela. Você também pode excluir um papel selecionando-o na lista de seleção que se encontra no final da tela de segurança e clicando no botão Delete Role. Você apenas pode excluir seus próprios papéis definidos, você não pode excluir nenhum dos papéis que vem com o Zope. Você deve reparar que os papéis podem ser usados no nível em que são definidos e abaixo dele na hierarquia dos objetos. Por exemplo, se você criar um papel em minhapasta, esse papel não poderá ser usado fora dela. Por isso, se deseja criar um papel que é apropriada para seu site inteiro, crie-o na pasta raiz. Em geral, papéis devem ser aplicáveis para grandes seções do seu site. Se você tem a intenção de criar um papel para restringir acesso a algumas seções de seu site, existem outras maneiras muito melhores de alcançar o mesmo efeito. Por exemplo, você pode simplesmente mudar as propriedades de segurança para os papéis já existentes na pasta que você quer proteger, ou pode definir usuários abaixo na 69

71 hierarquia de objetos para limitar seu acesso. Mais tarde, no capítulo, examinaremos mais exemplos de como definir políticas de segurança. Entendendo Papéis Locais Local roles (papéis locais) é uma característica avançada da segurança do Zope. Usuários podem ganhar papéis extras quando trabalham com certos objetos ao usar local role. Se um objeto tem um papel local associado a um usuário então aquele usuário adquire aqueles papéis adicionais enquanto trabalha com aquele objeto, sem precisar se autenticar novamente. Por exemplo, se um usuário cria um objeto, ele geralmente ganha o papel local de Owner enquanto estiver trabalhando com aquele objeto. Um usuário não poderia editar Page Templates em geral se não possuísse um papel global para fazer isso, mas para isso ele tem, pois o usuário pode ter acesso para editar Page Templates possuindo o papel local Owner. Papéis locais são um controle de segurança muito mais avançado e não são sempre necessários. No controle automático do Zope quanto ao papel local Owner é provavelmente o único lugar onde você encontra papéis locais. A principal razão de você querer controlar manualmente os papéis locais é para dar a um usuário especial um acesso especial a um objeto. Em geral, você deve evitar controles de segurança para um usuário específico, se possível. É mais fácil gerenciar configurações de segurança para grupos de usuários ao invés de usuários individuais. 70