Esquema breduperson versão 1.0

Transcrição

1 Esquema breduperson versão 1.0 Federação Café outubro de Introdução Neste documento descrevemos um esquema LDAP para pessoas participantes de instituições de ensino superior no Brasil. Esse esquema armazena informações específicas para a realidade do país, tais como: informações genéricas de qualquer cidadão residente no Brasil (cpf, entre outras), informações gerais sobre os membros de uma instituição ( , cargo, entre outros), além de informações específicas sobre os funcionários e alunos destas instituições. Recomenda-se, que este esquema seja utilizado de forma integrada com os seguintes esquemas LDAP que também descrevem informações sobre pessoas: inetorgperson [3], eduperson [1] e SCHAC [2]. 2 Estrutura do Esquema Num esquema a ser usado em instituições de ensino e pesquisa, precisamos modelar relacionamentos entre conjuntos de informações. Devemos poder capturar na base de dados, por exemplo, o fato de uma mesma pessoa poder desempenhar diferentes papéis de aluno, a cada um dos quais está associada uma data de ingresso, um código de curso, e outras informações, ou que uma mesma pessoa pode ter direito a vários números VoIP, cada um deles com suas características. Para modelar esses relacionamentos, optamos pelo uso de uma solução hierárquica, descrita a seguir. Os nós em um diretório LDAP formam uma árvore. Cada nó, independentemente de ser pai de algum outro nó na árvore, é uma entrada com suas próprias informações (atributos). Esses nós são por vezes chamados de containers na terminologia X500. O item principal (em nosso exemplo, uma pessoa com alguma ligação com instituição de ensino e/ou pesquisa) com o qual se deseja relacionar as demais informações será tratado como um container abaixo do qual aparecerão nós com as informações relacionadas. As próprias inserções de pessoa naquela instituição acadêmica aparecem como entradas abaixo das informações genéricas (nome, cpf, etc) sobre ela, pois cada pessoa pode ter diferentes vínculos com a instituição, como vínculo de estudante em curso, vínculo de funcionário, etc. Além disso, abaixo da entrada com dados gerais podem aparecer diversas entradas descrevendo telefones VoIP, dados biométricos, etc. Uma consequência dessa escolha é que classes que em princípio não precisariam ser definidas como estruturais passam a ser definidas dessa forma para permitir que suas informações apareçam em uma entrada independente. 2.1 Hierarquia e Classes de Objetos A entrada principal de cada usuário é um objeto de classe estrutural inetorgperson e com classes auxiliares schacpersonalcharacteristics, eduperson e brperson. A classe inetorgperson é definida na RFC e a classe schacpersonalcharacteristics é parte da proposta da Terena de extensões de esquemas padrão. A classe eduperson é mantida pelo grupo MACE da Internet2. Já a classe brperson é definida neste documento e tem o objetivo de capturar atributos específicos de pessoas 1 Essa classe também inclui atributos que usamos aqui e que são oriundos do X.500, como cn, sn, e telephonenumber, que são descritos na RFC

2 que vivem no Brasil. A entrada principal sobre um usuário deve conter todas as informações genéricas sobre o indivíduo. Abaixo dessa entrada principal, recomenda-se que exista pelo menos uma entrada de classe estrutural breduperson, que descreve um vínculo da pessoa com a instituição. Cada vínculo será descrito por uma entrada em separado, e pode haver um número arbitrário de tais entradas, refletindo diferentes vínculos de um indivíduo com a instituição. A classe de objetos breduperson define atributos que se aplicam a qualquer vínculo, como as datas de início e de final do vínculo. Classes auxiliares podem ser vir a ser definidas no futuro para incluir atributos relativos a cada tipo de vínculo. Além de vínculos, abaixo da entrada descrevendo um indivíduo podem aparecer uma ou mais entradas com classe brvoip ou brbiometricdata, definidas neste documento. Não existe obrigatoriedade de existência dessas entradas, uma vez que nem todas as instituições utilizam as informações que constam nelas. eduperson e breduperson A classe de objetos eduperson foi criada no contexto do Projeto Internet2 para descrever indivíduos da comunidade acadêmica. Aqui, o nome breduperson é utilizado para descrever a classe de objetos que representa um vínculo com a instituição por ser o objeto cujos campos mais se assemelham aos da classe eduperson [1]. O eduperson, no entanto, supõe apenas uma entrada por pessoa, com campos multivalorados descrevendo, por exemplo, os diversos vínculos de um indivíduo com a instituição. Esse modelo não satisfez as necessidades da Federação CAFe, pois precisamos associar a cada vínculo existente (professor, estudante, funcionário, etc) outras informações, como a data de entrada e saída. Em nosso esquema, tanto a entrada principal de cada indivíduo (de classe estrutural brperson) como cada entrada abaixo dessa que descreve um vínculo (de classe estrutural breduperson) têm a classe eduperson como auxiliar, pois atributos gerais dof indivíduo ficam na entrada principal enquanto que os atributos relativos a um de seus vínculos ficam na entrada específica de vínculo. Como este esquema completo também é dedicado à descrição de indivíduos com inserção em instituição acadêmica, utilizamos o mesmo nome breduperson para nos referirmos também ao esquema como um todo. 2.2 Exemplo A figura 1 apresenta o modelo de nomes da estrutura proposta. A Figura 2 apresenta um exemplo mais detalhado de um container nessa estrutura hierárquica. As classes breduperson e breduvoip são exemplos de classes utilizadas para armazenar informações (vínculos e telefones IP) relacionadas a uma pessoa. Cada objeto de classe breduperson deve ser encarado como uma das várias personas que uma determinada pessoa pode apresentar. Com isso podemos dar suporte a representações de vínculos básicos, de aluno, funcionário, professor, pesquisador, etc, e ainda a posições temporárias, como coordenador, diretor, etc. No exemplo da figura, a pessoa Silvana Rosseto aparece com um vínculo ativo de professor adjunto e um vínculo já vencido de pro-reitor. 3 Classes de objetos e atributos Nesta seção são descritos as classes de objetos e atributos que compõem o esquema breduperson 3.1 brperson A classe auxiliar de objetos brperson é uma classe de objeto construída para descrever as informações sobre as pessoas nascidas ou residentes no Brasil e não se restringe somente ao âmbito 2

3 dc=br dc=uff ou=people ou=depts... uid=s cn=silvana braff=01 brafftype=faculty braff=02 brafftype=student braff=03 brafftype=position Figura 1: Espaço de nomes nomes em uma instituição educacional. objectclass ( NAME brperson DESC Atributos sobre pessoas nascidas ou residentes no Brasil, que nao se restringe somente ao ambito educacional SUP top AUXILIARY MAY ( brcpf $ brpassport ) ) ) No esquema breduperson, recomendamos que a classe brperson seja a classe da entrada que funciona como container para as informações relacionadas a uma pessoa com inserção em instituição de ensino ou pesquisa. A seguir descrevemos cada atributo recomendado para as entradas descrevendo uma tal pessoa. 1. Nome LDAP attribute name cn X.500 strongly syntax nomes pelos quais a pessoa é conhecida André Barbosa da Silva André Silva Andrézinho Recomendamos que exista sempre um valor desse atributo com o nome completo da pessoa. 3

4 dn: uid=s ,ou=people,dc=uff,dc=br objectclass: inetorgperson objectclass: brperson objectclass: schacpersonalcharacteristics uid: S brcpf: brpassport: A23456 schaccountryofcitizenship: Brazil telephonenumber: Mail: homepostaladdress:... cn: Silvana cn: Silvana Rossetto sn: Rossetto userpassword: silvana schacdateofbirth: schacgender: 2 dn: braff=01,uid=s ,ou=people,dc=uff,dc=br objectclass: breduperson braff: 01 brafftype: student brentrancedate: dn: braff=02,uid=s ,ou=people,dc=uff,dc=br objectclass: breduperson braff: 02 brafftype: faculty brentrancedate: brexitdate: dn: brvoipalias=5020,uid=s ,ou=people,dc=uff,dc=br objectclass: breduvoip breduvoipalias: 5020 breduvoiptype: pstn breduvoipadmin: uid=a ,ou=people,dc=uff,dc=br breduvoipcallforward: breduvoipaddress: breduvoipexpirydate: breduvoipbalance: breduvoipcredit: dn: brvoipalias=2345,uid=s ,ou=people,dc=uff,dc=br objectclass: breduvoip brvoipalias: 2345 breduvoiptype: celular breduvoipadmin: uid=a ,ou=people,dc=uff,dc=br Figura 2: Estrutura das entradas no esquema 4

5 2. Sobrenome LDAP attribute name sn X.500 strongly syntax sobrenome Barbosa 3. CPF LDAP attribute name brpersoncpf brperson syntax Cadastro Pessoa Física attributetype ( NAME ( brpersoncpf brcpf ) DESC Cadastro Pessoa Fisica EQUALITY caseignorematch SYNTAX Observe que definimos brcpf como apelido para esse atributo. 4. Passaporte LDAP attribute name brpersonpassport brperson syntax documento emitido por um governo nacional ZF O valor desse atributo é complementado pela informação no atributo país de cidadania. 5

6 attributetype ( NAME ( brpersonpassport brpassport ) DESC Numero do passaporte EQUALITY caseignorematch SYNTAX Observe que definimos brpassport como apelido para esse atributo. 5. Data de Nascimento LDAP attribute name schacdateofbirth schacpersonalcharacteristics syntax data de nascimento País de Cidadania LDAP attribute name schaccountryofcitizenship schacpersonalcharacteristics syntax país emissor do passaporte múltiplo es Formalmente, esse atributo admite valores. Recomendamos que apenas um seja utilizado. 7. Identificador de Usuário LDAP attribute name uid inetorgperson syntax conta do usuário S123456, asilva Esse atributo contém nomes para login associados ao usuário. 8. Identificados na Federação 6

7 LDAP attribute name eppn eduperson strongly syntax nome do usuário na federação O atributo edupersonprincipalname tem o propósito de permitir que se identifique o usuário de forma única na federação sem divulgar informação que revele sua identidade explicitamente. 9. Número de telefone LDAP attribute name telephonenumber X.500 syntax Especifica um telefone de contato Endereço eletrônico LDAP attribute name mail InetOrgPerson strongly syntax {256} de contato alguem@puc-rio.inf.br 11. Certificado Digital 12. Senha LDAP attribute name usercertificate InetOrgPerson syntax certificado digital 7

8 LDAP attribute name userpassword InetOrgPerson syntax senha para autenticação {SHA1}984e18fe201c8f99e0e443707= 13. Endereço postal domiciliar LDAP attribute name homepostaladdress InetOrgPerson syntax Endereço Postal Rua Marquês de São Vicente, 225 Gávea Rio de Janeiro, RJ Brasil As classes que vêm descritas a seguir descrevem objetos que aparecerão abaixo de um objeto brperson. Cada uma delas deve definir um atributo obrigatório e de valor que componha, em combinação com o dn da pessoa, o dn da nova entrada. 3.2 breduperson A classe estrutural de objetos breduperson serve para definir inserções em instituição brasileira de ensino ou pesquisa. objectclass ( NAME breduperson DESC Atributos referentes a uma pessoa com insercao em instituicao brasileira de ensino ou pesquisa SUP top STRUCTURAL MUST ( breduaffiliation $ breduaffiliationtype) MAY ( brentrancedate $ brexitdate ) ) Essa classe tem valor especial em nosso esquema, pois deve haver na base um objeto de classe breduperson para descrever cada vínculo (cargo, função provisória, bolsa, etc) que uma pessoa mantiver com a instituição. A seguir descrevemos cada atributo recomendado para as entradas descrevendo uma pessoa com inserção em instituição brasileira de ensino ou pesquisa. 1. vínculo 8

9 LDAP attribute name breduaffiliation breduperson syntax identificação desse vínculo particular 02 O valor deve ser em relação às entradas irmãs. Combinamos de usar números sequenciais para descrever os diferentes vínculos de uma pessoa. Esse atributo é o utilizado para compor o dn da entrada. attributetype ( NAME ( breduaffiliation braff ) DESC identificador de um vínculo particular mantido pela pessoa na instituicao SYNTAX Observe que definimos braff como apelido para esse atributo. 2. tipo de vínculo LDAP attribute name breduaffiliationtype breduperson strongly syntax tipo de vínculo que a pessoa possui com a instituição. employee Esse atributo aceita um valor. Os valores possíveis são enumerados a seguir, na definição do atributo. attributetype ( NAME ( breduaffiliationtype brafftype ) DESC Tipo de vinculo com a instituicao EQUALITY caseignorematch SYNTAX

10 Observe que definimos brafftype como apelido para esse atributo. Os valores possíveis para o atributo breduaffiliationtype são: student faculty employee alum other (contrato de outro tipo) position (coordenador, etc) scholarshipawardee (iniciação, pós,...) Para alguns dos valores do atributo breduaffiliationtype serão definidas classes auxiliares correspondentes, que definem campos específicos a esse tipo de vínculo (por exemplo, descrição do curso, no caso de estudante). 3. Data de início LDAP attribute name brentrancedate breduperson syntax data do início desse vínculo attributetype ( NAME ( brentrancedate brentr ) DESC Data de inicio desse vinculo SYNTAX Observe que definimos brentr como apelido para esse atributo. 4. Data de saída 10

11 LDAP attribute name brexitdate breduperson syntax data do fim desse vínculo Um valor de data de fim de vínculo anterior à data corrente indica que o vínculo não existe mais. Caso não exista o campo com data de fim de vínculo, supõe-se que o vínculo esteja ativo. attributetype ( NAME ( brexitdate brexit ) DESC Data de fim desse vínculo SYNTAX Observe que definimos brexit como apelido para esse atributo. 3.3 breduvoip A classe estrutural breduvoip é utilizada para armazenar dados relativos a um telefone IP. objectclass ( NAME breduvoip DESC Atributos com dados relativos a um telefone IP SUP top STRUCTURAL MUST ( breduvoipphone $ brvoipalias $ brvoiptype $ brvoipadmin ) MAY ( brvoipfwr $ brvoipaddr $ brvoipexpiry $ brvoipbalance $ brvoipcredit ) ) A seguir descrevemos cada atributo recomendado para as entradas descrevendo um telefone IP. 1. Número IP 11

12 LDAP attribute name breduvoipphone breduvoip syntax identificação desse telefone 5780 O valor deve ser em relação às entradas irmãs. Combinamos de usar números sequenciais para descrever os diferentes telefones associados a uma pessoa. Esse atributo é o utilizado para compor o dn da entrada. 2. Número IP attributetype ( NAME ( breduvoipphone brvphone ) DESC identificador SYNTAX LDAP attribute name breduvoipalias breduvoip syntax número do telefone IP 5780 attributetype ( NAME ( breduvoipalias brvoipalias ) DESC Numero do telefone IP EQUALITY numericstringmatch SYNTAX Observe que definimos brvoipalias como apelido para esse atributo. 3. Categoria 12

13 LDAP attribute name breduvoiptype breduvoip syntax categoria do usuário para tratamento diferenciado pstn, celular, etc attributetype ( NAME ( breduvoiptype brvoiptype ) DESC Tipo do telefone IP EQUALITY caseignorematch SYNTAX Observe que definimos brvoiptype como apelido para esse atributo. 4. Responsável LDAP attribute name breduvoipadmin breduvoip syntax dn do responsável pela criação do usuário attributetype ( NAME ( breduvoipadmin brvoipadmin ) DESC Administrador responsavel por telefone VoIP EQUALITY distinguishednamematch SYNTAX ) Observe que definimos brvoipadmin como apelido para esse atributo. 5. Número para redirecionamento 13

14 LDAP attribute name breduvoipforward breduvoip syntax telefone para redireção de chamada caso o usuário não esteja online O usuário pode indicar um telefone comum para redirecionamento de chamadas caso não possa ser alcançado nesse telefone IP. attributetype ( NAME ( breduvoipcallforward brvoipfwr ) DESC Numero do telefone comum para redirecao de chamada SYNTAX ) Observe que definimos brvoipfwr como apelido para esse atributo. 6. Endereço IP LDAP attribute name breduvoipaddress breduvoip syntax verificar se existe uma sintaxe padrão?? se presente, indica IP obrigatório para usuário se registrar Pode existir uma limitação de que o usuário só use esse telefone IP a partir de certos endereços IP. Nesse caso, este campo registra um endereço IP autorizado. Caso não exista o campo, não existe limitação. attributetype ( NAME ( breduvoipaddress brvoipaddr ) DESC Endereco IP do telefone SYNTAX ) Observe que definimos brvoipaddr como apelido para esse atributo. 7. Data de expiração 14

15 LDAP attribute name breduvoipexpirydate breduvoip syntax data de expiração da conta Ao atribuir um telefone IP, o administrador pode opcionalmente determinar uma data de expiração para a atribuição. A existência desse campo com data anterior à data atual identifica uma conta obsoleta. Caso o campo não exista ou contenha data posterior à atual, supõe-se que a conta esteja ativa. attributetype ( NAME ( breduvoipexpirydate brvoipexpiry ) DESC Data de expiracao do telefone IP SYNTAX Observe que definimos brvoipexpiry como apelido para esse atributo. 8. Créditos restantes LDAP attribute name breduvoipbalance breduvoip syntax saldo em segundos attributetype ( NAME ( breduvoipbalance brvoipbalance ) DESC Creditos restantes em um telefone IP (em segundos) SYNTAX Observe que definimos brvoipbalance como apelido para esse atributo. 9. Créditos por período 15

16 LDAP attribute name breduvoipcredit breduvoip syntax crédito em segundos ao qual usuário terá direito (diário, semanal,...) attributetype ( NAME ( breduvoipcredit brvoipcredit ) DESC Total de creditos do usuario (em segundos) SYNTAX Observe que definimos brvoipcredit como apelido para esse atributo. 3.4 brbiometricdata A classe estrutural brbiometricdata é utilizada para armazenar dados biométricos das pessoas. objectclass ( NAME brbiometricdata DESC Atributos sobre dados biometricos das pessoas SUP top STRUCTURAL MUST ( brbiosrc $ brbiodata ) MAY ( brcapt ) ) A seguir descrevemos cada atributo recomendado para as entradas descrevendo dados biométricos. 1. Data de captura LDAP attribute name capturedate brbiometricdata syntax Representa a data de captura do dado biométrico da pessoa

17 attributetype ( NAME ( brcapturedate brcapt ) DESC Data de captura do dado biometrico da pessoa SYNTAX Observe que definimos brcapt como apelido para esse atributo. 2. Fonte de Dados LDAP attribute name biometricdatasource brbiometricdata syntax Representa uma fonte biométrica da pessoa. left-middle O valor deve ser em relação às entradas irmãs. Esse atributo é o utilizado para compor o dn da entrada. attributetype ( NAME ( brbiometricsource brbiosrc ) DESC Fonte biometrica da pessoa EQUALITY caseignorematch SYNTAX Observe que definimos brbiosrc como apelido para esse atributo. Esse atributo aceita os valores: left-thumb, left-index, left-middle, left-ring, left-little, rightthumb, right-index, right-middle, right-ring e right-little. 3. Dados biométricos LDAP attribute name biometricdata brbiometricdata syntax Representa o dado capturado de uma fonte biométrica da pessoa 17

18 attributetype ( NAME ( brbiometricdata brbiodata ) DESC Dado capturado de uma fonte biometrica da pessoa SYNTAX ) Observe que definimos brbiodata como apelido para esse atributo. Referências [1] Internet2 Middleware Architecture Committee for Education (MACE). Internet2-mace-direduperson middleware.internet2.edu/eduperson/, [2] TERENA (Trans-European Research and Education Networking Association). SCHAC (SCHema for ACademia) attribute definitions for individual data. activities/tf-emc2/schacreleases.html, [3] M. Smith. Definition of the inetorgperson LDAP Object Class. txt, April RFC 2798 (Updated by RFCs 3698, 4519, 4524). 18