Manual d Usuári - C3Web 2017 E-sec Segurança Digital. Tds s direits reservads.
Table f cntents Bem vind!...4 Iniciand C3web...4 Pré-requisits para utilizaçã d sistema...4 Outras Cnsiderações...4 Glssári...4 Usuáris...6 Emissã de Certificads...6 Flux de Geraçã e Assinatura de Certificads...6 Flux de Mdelagem e Entrega de Certificads...7 Manual d Administradr...9 Prcediment Básics...9 Gerência de Usuáris...9 Cadastrar Usuári...9 Visualizar/Editar Dads de um Usuári...9 Remver Usuári...10 Gerência de Carg...10 Criar Carg...10 Listar e Editar Carg...10 Vincular Pessa a Carg...11 Gerência de Templates...12 Cadastrar Template de Certificad...12 Template PDF...12 Uplad d Template PDF...12 Parâmetr de Imagem n Template PDF...13 Uplad de Imagens para PDF...15 Template XML...16 Arquiv XML Parametrizad...16 Uplad d template XML...17 Adiçã de Fnte de PDF...18 Adicinar Fnte n IReprt...18 Exprtar Fnte d IRprt...21 Adicinar Fnte a Prjet...22 Autenticaçã de Web Service...22 Cadastrar Tken de Acess...22 Listar e Inativar Tken de Acess...23 Manual d Supervisr...23 Prcess de Emissã ds Certificads...23 Caixa de Trabalh d Supervisr...23 Visualizar e Aprvar Prcess de Emissã...23 Visualizar Certificad em PDF e XML...24 Supervisã das Emissões ds Certificads...24 Listar e Visualizar Prcess de Emissã...24 Cancelar Prcess de Emissã...25 Cancelar Certificad...25 Manual d Operadr...26 Template...26 2 / 31
Uplad d Template PDF...26 Parâmetr de Imagem n Template PDF...26 Uplad de Imagens para PDF...29 Manual d Signatári...30 Prcess de Emissã ds Certificads...30 Caixa de Trabalh e Tarefas Pendentes...30 Visualizar Tarefas Pendentes...30 Visualizar Certificads em PDF e XML...31 Assinar lte de Certificads...31 3 / 31
Bem vind! Iniciand C3web O C3Web é um sistema WEB para gestã da emissã de Certificads de Cnclusã de Curs em frmat digital. Vist que a emissã de Certificads em papel pde significar um grande cust para uma instituiçã de ensin e a gerência manual é muit trabalhsa, esse sistema de emissã de Certificads digitais tem cm bjetiv ser facilmente integrável as sistemas de infrmaçã da instituiçã de ensin, auxiliand a gerência n prcess de assinatura e entrega d Certificad a Alun de frma nline. O C3Web é divid em dis móduls: Geraçã e Assinatura de Certificads Mdelagem e Entrega de Certificads Fazem parte d prcess de emissã d Certificad, s Usuáris, que sã as pessas autrizadas a gerenciar sistema. Sã eles: Administradr, Operadr, Supervisr e Signatári. Pré-requisits para utilizaçã d sistema Para utitilizar C3Web é necessári que sejam cumprids s seguintes requisits: Sistema Operacinal: Windws, Linux u Mac OS. JRE 7 u 8 e plugin instalad e ativ n navegadr. Verifique se n seu navegadr há um Plug-in Java habilitad através d site http://www.java.cm/pt_br/dwnlad/installed.jsp Outras Cnsiderações É recmendad us d navegadr Internet Explrer para acessar sistema. Independente d perfil d usuári, ele só pde acessar as funcinalidades d sistema cas esteja devidamente autenticad neste. Antes diss, cas crra falha em sua autenticaçã, u após expirada a sessã, nã é pssível ter acess a tais funcinalidades. A interface desta versã é unicamente em Prtuguês d Brasil. Glssári Este glssári tem cm bjetiv cbrir tdas as siglas e terms cmplexs usads n manual. A Assinatura Digital: É um métd de autenticaçã de infrmaçã digital tipicamente tratada cm análga à assinatura física em papel. C Carg: O Carg é a funçã de um Signatári, cm pr exempl: Decana de Extensã e Secretári de Administraçã Acadêmica. Certificad de Cnclusã: É um dcument digital emitid pel sistema certificand que um Alun cncluiu um determinad Curs. CSV: Cmma Separated Values (CSV) é um frmat de arquiv de text que pde ser usad para trcar dads de uma planilha entre aplicações. Cada linha em um arquiv de Text CSV representa 4 / 31
uma linha em uma planilha. N C3Web, CSV é um arquiv utilizad para imprtaçã d lte de assinatura e cntém dads separads pr vírgula. Códig de Verificaçã: Códig únic d Certificad utilizad para verificar a autenticidade d dcument. D Dcument de identificaçã: Dcument utilizad para Identificaçã de um Alun. Exempls: Dcument de Identidade brasileir, CPF, Passaprte, entre utrs. Dwnlad: É quand se faz a transferência de dads armazenad em um servidr remt para cmputadr lcal. Mais cnhecid cm baixar um arquiv dispnível na internet. J JRXML: Arquivs JRXML cntribuem para a fácil e rápida criaçã de relatóris cm elements de design, camps de text, gráfics, variáveis, layut d relatóri, imagens e parâmetrs. JSON: JSON é um acrônim para JavaScript Object Ntatin, é um frmat leve para intercâmbi de dads cmputacinais. JSON é um subcnjunt da ntaçã de bjet de JavaScript, mas seu us nã requer JavaScript exclusivamente. L Lte de Assinatura: É um cnjunt de Slicitações de Assinatura imprtad para sistema através d arquiv CSV u enviad através de WebService. M Mdel: O Mdel define a aparência e s dads ds Certificads de Cnclusã que serã gerads. Também define quais parâmetrs devem cnter n lte de imprtaçã (CSV). O OutputStream: O OutputStream é capaz de enviar dads a um determinad Stream. Um prgrama que precise escrever um dad em algum lcal (destin) precisa de um OutputStream u um Writer. Nã é a finalidade desse manual explicar cm tratar OutputStream. P PDF: Inventad pela Adbe Systems, PDF é um frmat de arquiv usad para exibir e cmpartilhar dcuments de maneira cmpatível, independentemente de sftware, hardware u sistema peracinal. S Signatári: Respnsável pr assinar s Cerificads de Cnclusã de Curs. Para uma pessa ser um Signatári deve estar vinculada à um Carg. T Template PDF: Através ds templates é pssível cnfigurar C3Web para gerar certificads cm aspect desejad. Um template PDF define a aparência que s Certificads de Cnclusã gerads n frmat PDF deverã ter. 5 / 31
Template XML: Arquiv que cntém a estrutura ds Certificads que serã emitids. Template XML é um arquiv text parametrizad que pssibilita a geraçã d certificad de cnclusã n frmat XML. U Uplad: É at invers a dwnlad, u seja, é envi de dads de um cmputadr lcal para um cmputadr u servidr remt geralmente através da internet. X XML: É uma linguagem de marcaçã recmendada para a criaçã de dcuments cm dads rganizads hierarquicamente. O XML é capaz de descrever diverss tips de dads, e seu bjetiv principal é a facilidade de cmpartilhament de infrmações através da Internet. XADES: Permite a validaçã ds dcuments n decrrer d temp, facilitam a interperabilidade, a atualizaçã tecnlógica da segurança e a pssibilidade de múltiplas assinaturas em um mesm dcument. O padrã XadES é recmendad para assinatura de dcuments n frmat XML. A partir destes padrões é dispnibilizad um cnjunt de frmats para assinatura digital padrã ICP-Brasil. Usuáris O acess a C3Web está divid em Grup de Usuáris e de Aluns. O grup de Usuáris é cmpst pelas pessas autrizadas a gerenciar Sistema. O grup de Aluns é cmpst pelas pessas às quais s Certificads de Cnclusã fram emitids. Os Usuáris sã cadastrads pel administradr que lhes atribui um u mais perfis. Cada perfil tem acess a um determinad cnjunt de funcinalidades, u seja, um Usuári a efetuar lgin é autrizad a realizar as perações atribuídas a seu perfil. Quand Usuári tentar realizar uma peraçã nã permitida, é exibida uma mensagem de err. Pertencem a grup de Operadres s seguintes perfis: 1. Administradr: Respnsável pr cnfigurar sistema para que Prcess de Emissã ds Certificads seja iniciad. O administradr tem cm principais respnsabilidades: Gerenciar dads de uma determinada unidade rganizacinal. Criar Curss, Definir seus signatáris através da atribuiçã ds Cargs. 2. Operadr: Respnsável pr submeter Templates de Certificad. 3. Supervisr: Respnsável pr avaliar s dads d arquiv de imprtaçã de lte de assinaturas imprtads pel Operadr e submeter prcess para assinatura. Pde ainda cancelar um Certificad emitid errneamente. 4. Signatári: Respnsável pr assinar lte de requisiçã de assinaturas que fi aprvad pel Supervisr. Emissã de Certificads Flux de Geraçã e Assinatura de Certificads Este flux descreve uma das frmas de realizar prcess de emissã de certificads de cnclusã. Nesse cas, lte será cmputad n sistema através de WebService. Os seguintes perfis d sistema fazem parte d prcess de emissã d Certificad: Administradr: realiza cnfigurações n sistema. Ações e cnfigurações estã descritas n manual d administradr. 6 / 31
Supervisr: realiza supervisã de prcess de emissã de certificads. As ações referidas a este perfil estã descritas n manual d supervisr. Signatári: realiza assinatura em lte de slicitações de emissã de certificads de cnclusã. Prcess de emissã Descriçã Para iniciar prcess de Emissã d Certificad de Cnclusã de Curs, é necessári que Administradr cadastre as templates PDF e XML, que serã utilizads para gerar s Certificads cm a aparência desejada, e um Tken de Acess, que habilita um webservice a se cmunicar cm sistema. O Administradr deve criar, também, um Carg (funçã de um Signatári) e atribuir uma pessa a esse Carg, para permitir que esta pessa seja um Signatári de Certificad de Cnclusã. O Signatári é respnsável pr assinar s Certificads de Cnclusã. Ele pderá listar as assinaturas que estã pendentes e realizar a assinatura d lte submetid. Flux de Mdelagem e Entrega de Certificads Este flux descreve uma das frmas de realizar prcess de emissã de certificads de cnclusã. Nesse cas, lte será cmputad n sistema através d uplad de arquiv CSV. Os seguintes perfis d sistema fazem parte d prcess de emissã d Certificad: Administradr: realiza cnfigurações n sistema. Ações e cnfigurações estã descritas n manual d administradr. Operadr: uplad de template. Está açã está descrita n manual d peradr. 7 / 31
Supervisr: realiza supervisã de prcess de emissã de certificads. As ações referidas a este perfil estã descritas n manual d supervisr. Signatári: realiza assinatura em lte de slicitações de emissã de certificads de cnclusã. Prcess de emissã Descriçã Para iniciar prcess de Emissã d Certificad de Cnclusã de Curs, é necessári que Administradr cadastre s Dcuments de Identificaçã, que serã utilizads nas templates PDF e XML. O Administradr deve criar, também, um Carg (funçã de um Signatári) e atribuir uma pessa a esse Carg, para permitir que esta pessa seja um Signatári de Certificad de Cnclusã. Após a cnfiguraçã d sistema pel Administradr, Operadr cadastrará as slicitações de Certificad de Cnclusã, dand iníci a prcess de emissã ds mesms. Em seguida Supervisr irá avaliar e aprvar lte de assinatura imprtad pel Operadr, submetend prcess para assinatura. O Signatári é respnsável pr assinar s Certificads de Cnclusã. Ele pderá listar as assinaturas que estã pendentes e realizar a assinatura d lte submetid. O alun é a pessa para a qual fi emitid um Certificad de cnclusã de curs. Ele será ntificad que um nv Certificad está dispnível após últim Signatári realizar a assinatura. Em seguida alun faz lgin n C3Web e efetua dwnlad d Certificad devidamente assinad. O verificadr será a pessa que verificará a autenticidade d dcument. A final d prcess de emissã, sistema gera um códig únic d dcument que será utilizad para realizar a verificaçã d certificad. O alun cmunica a verificadr Códig de Verificaçã d seu Certificad, Verificadr entã deve acessar a URL dispnível n Certificad d alun, infrmar códig de verificaçã e clicar em Buscar, em seguida sistema redirecina para tela de visualizaçã d Certificad de Cnclusã. 8 / 31
Manual d Administradr Prcediment Básics Antes de iniciar Prcess de Emissã d Certificad de Cnclusã de Curs, Administradr deverá: 1. Cadastrar um u mais Supervisres: O Administradr cadastrará s usuáris que serã Supervisres, para que aprvem u rejeitem s ltes de certificads. 2. Cadastrar um u mais Cargs: Nesta funcinalidade, Administradr criará s Cargs que assinarã s certificads. A criaçã de Carg tem cm principal bjetiv assciar Signatáris a um Curs. Mais em: Criaçã e Ediçã de Carg. 3. Vincular uma Pessa a Carg: Para assinar certificads é necessári atribuir pessas a Cargs. Estes serã s Signatáris d certificad. Mais em: Vincular Pessa a Carg. 4. Cadastrar um u mais Templates: Os templates sã necessáris para geraçã d Certificad de Cnclusã de Curs n frmat PDF e XML. O Administradr deve fazer uplad ds templates para geraçã d Certificad de Cnclusã de Curs n frmad PDF e XML. Devend ser template PDF um arquiv text cm esquema xml JRXML (ireprts). E template XML um arquiv text parametrizad. Gerência de Usuáris Cadastrar Usuári N C3Web, fazem parte d prcess de emissã d Certificad, s Usuáris, que sã as pessas autrizadas a gerenciar sistema. Sã eles: Administradr, Operadr, Supervisr. Cadastrar Usuári 1. Acine menu Entidades > Usuáris. 2. Clique em Criar nv Usuári. 3. Infrme s camps: CPF (brigatóri). Lgin (brigatóri). Primeir nme (brigatóri). Últim nme (brigatóri). E-mail (brigatóri). Esclha perfil d nv usuári: Supervisr Operadr 4. Clique em Salvar. Visualizar/Editar Dads de um Usuári 1. Acine menu Entidades > Usuáris. 2. Deve aparecer uma lista cm tds s usuáris cadastrads n sistema. 3. Para visualizar um usuári, clique n btã Visualizar. 4. Para editar s dads d usuári, clique n btã Editar. 5. Camps que pdem ser editads: 9 / 31
Lgin Primeir nme Últim nme E-mail Perfil 6. Clique n btã Salvar. Remver Usuári 1. Acine menu Entidades > Usuáris. 2. Clique n btã Excluir na linha d usuári desejad. 3. Na janela de cnfirmaçã, clique em Cnfirmar. Observaçã Um usuári só pderá ser remvid cas nã esteja vinculad a nenhum Carg. Gerência de Carg Criar Carg N C3Web a atribuiçã da respnsabilidade de assinar s Certificads é realizada através de vinculaçã de Cargs à Curss. Entã antes de realizar cadastr de um Curs é necessári cadastrar s Cargs da instituiçã que assinarã s Certificads de Cnclusã de Curs. Neste e ns próxims tópics abrdarems a Gerência de Carg, send ela cmpsta das seguintes funcinalidades: "Criaçã e Ediçã de Carg" e "Vinculaçã de uma pessa a um Carg". Passs par criaçã de um Carg: 1. Acine menu Entidades > Signatáris. 2. Clique n btã Criar nv Carg. 3. Infrme nme desejad para Carg (brigatóri). 4. Para adicinar um usuári a carg, selecine camp em Deseja adicinar um usuári?. 5. Infrme CPF d usuári e clique em Prcurar. 6. Deve aparecer s dads d usuári. 7. Clique n btã Salvar. O Carg especificad é cadastrad n sistema, devend agra ter uma Pessa vinculada. Listar e Editar Carg 1. Acine menu Entidades > Signatáris. 2. Vcê deve cnseguir visualizar uma lista cm tds s cargs cadastrads. 3. Para editar s dads de um carg, clique em Editar. 4. Altere nme d Carg. 5. Altere usuári, infrmand CPF e clicand em prcurar. 10 / 31
6. Deve aparecer s dads d nv usuári. 7. Clique n btã Salvar. Observaçã O Carg só pderá ser editad se nã pssuir nenhuma assinatura pendente. O Administradr só terá acess as Cargs da sua Unidade Organizacinal. Vincular Pessa a Carg Após a criaçã d Carg devems vinculá-l a uma Pessa, pssibilitand que esta Pessa seja um Signatári e assine s Certificads de Cnclusã de Curs. Após a vinculaçã de uma Pessa a Carg, vcê deve atribuir tais Cargs a Curs a qual eles serã respnsáveis pelas assinaturas ds Certificads. Na próxima seçã Criar Curs e Definir seus Signatáris vcê encntra as infrmações necessárias para criar um Curs cm Signatáris. Para realizar a vinculaçã será necessári preencher frmulári cm s dads d Signatári. Esse frmulári é cmpst ds seguintes camps: CPF (brigatóri). Lgin (brigatóri). Primeir nme (brigatóri). Últim nme (brigatóri). E-mail (brigatóri). Passs para Vincular uma Pessa a Carg 1. Acine menu Entidades > Signatáris. 2. Clique n btã Visualizar. 3. Infrme CPF da pessa que deseja vincular. 4. Clique n btã Prcurar. 5. Preencha s camps d frmulári cm s dads da pessa: Se CPF já estiver cadastrad sistema exibe um frmulári cm s dads d Signatári preenchids. Se CPF nã estiver cadastrad sistema exibe um frmulári para preenchiment ds dads d Signatári. 6. Clique n btã Salvar. Observaçã O Administradr só terá acess as Cargs da sua Unidade Organizacinal. 11 / 31
Gerência de Templates Cadastrar Template de Certificad O template é utilizad para cnfigurar a aparência ds certificads de cnclusã que serã gerads em PDF e XML. Para a cnstruçã d certificad em PDF, é necessári que vcê faça uplad de um arquiv text cm esquema JRXML, esse arquiv deve cnter a estrutura ds certificads que serã emitids n frmat PDF. Para a cnstruçã d certificad em XML, é necessári que vcê faça uplad de um arquiv text cm esquema XML, esse arquiv deve cnter a estrutura ds certificads que serã emitids n frmat XML. Os parâmetrs definids n arquiv JRXML e XML devem ser infrmads na slicitaçã de assinatura em lte de certificads. Cadastrar Template: Acine menu Entidades > Template de Diplma. Clique n btã Criar nv Template. Preencha nme d Template. Exempl: Template de Certificads de Curss de Extensã. Realize uplad d template JRXML. Realize uplad de imagens para JRXML. Realize uplad d template XML. Clique n btã Salvar. Observações Os templates PDF e XML deverã utilizar a Cdificaçã de caracteres UTF-8. Após cadastr, template nã pderá ser editad. Template PDF Uplad d Template PDF O template PDF é utilizad para cnfigurar a aparência ds certificads de cnclusã que serã gerads. Para a cnstruçã d certificad em PDF, é necessári que vcê faça uplad de um arquiv text cm esquema JRXML, esse arquiv deve cnter a estrutura ds certificads que serã emitids n frmat PDF. Os parâmetrs definids n arquiv JRXML devem ser infrmads na slicitaçã de assinatura em lte de certificads. Uplad d Template e Visualizaçã d PDF: Acine menu Entidades > Template de Diplma. Clique n btã Criar nv Template. Clique n btã Selecinar arquiv PDF(JRXML). Selecine arquiv JRXML desejad. Clique n btã Salvar. 12 / 31
Observações O template PDF deve utilizar a Cdificaçã de caracteres UTF-8. Para salvar template JRXML, é necessári que tenham sid selecinadas as imagens (se tiver) e um arquiv XML. Parâmetr de Imagem n Template PDF Quand huver a necessidade de que s certificads gerads pssuam imagens, será precis criar template PDF cm parâmetr de imagem. A seguir auxiliarems a criar template PDF cm parâmetr de imagem utilizand a ferramenta ireprt. O ireprt é uma ferramenta gratuita que pssibilita criar template PDF e é amplamente utilizada em desenvlviment de sistemas. Ela gera um arquiv cm extensã.jrxml nde é descrit a estrutura d arquiv PDF e s parâmetrs d certificad. Dwnlad e Instalaçã d ireprt: O ireprt está dispnível n site http://ireprt.surcefrge.net. A sua instalaçã é padrã (dupl clique e nexts). Criand template n ireprt: Após a instalaçã d ireprt vcê pde criar template cnfrme desejad. Para mais infrmações de cnfiguraçã e criaçã d template através d ireprt acesse: https://cmmunity.jaspersft.cm/wiki/designing-reprt. Incluind parâmetr de imagem n template: Pdems incluir n template PDF s parâmetrs que desejams que sejam exibids quand certificad fr gerad: 1. Abra template PDF cm a extensã.jrxml pel ireprt. 2. Lcalize n lad esquerd da ferramenta a aba Reprt Inspectr. 3. Clique cm btã direit d muse em Parameters e em Adicinar Parameter. 4. Selecine parâmetr criad e lcalize d lad direit da tela a aba Prpriedades. 5. Na aba prpriedades, altere nme d parâmetr na seçã Name. 13 / 31
6. Esclha a classe d parâmetr java.i.inputstream na seçã Parameter Class. Obs.: Inicialmente vai estar selecinada a pçã java.util.string. 7. Ative a paleta d ireprt através d cmand Crtl+Shitf+8. 8. Clique e arraste para dcument ícne Image dispnível na paleta. É exibida uma tela de seleçã de arquivs. 9. Selecine uma imagem u cancele a peraçã de seleçã d arquiv. Obs.: A imagem selecinada nã será exibida n template, prém, será exibida n dcument uma área retangular cm uma imagem default nde a imagem deverá ser renderizada. 10. Clique sbre element de imagem que vcê arrastu para dcument. 11. Lcalize d lad direit da tela a aba Prpriedades. 12. Na aba prpriedades, altere Expressin Class d element imagem para java.i.inputstream. 13. Clique n ícne... em Imagem Expressin. 14. Lcalize na listagem parâmetr criad n pass 4. 15. Clique duas vezes sbre ele para seleciná-l. 14 / 31
16. Após selecinad parâmetr clique em OK. O template PDF pssui agra parâmetr de imagem. Quand arquiv fr dispnibilizad n C3Web e as imagens frem selecinadas para template, essas imagens deverã crrespnder a nme ds parâmetrs de imagem criads. Observaçã Lembre-se de infrmar, n pass 5, nme d parâmetr de imagem cm a extensã. Ex.: $P{MinhaImagem.png}. Onde nme da imagem é MinhaImagem e a extensã png. Uplad de Imagens para PDF Para definir quais imagens irã cmpr certificad, é precis incluí-las n Template de acrd cm parâmetr de imagem criad n arquiv JRXML. As imagens deverã ter a extensã JPG, JPEG u PNG e pssuir mesm nme d parâmetr de imagem utilizad template PDF( arquiv JRXML). 1. Acine menu Entidades > Template de Diplma. 2. Clique n btã Criar nv Template. 3. Clique n btã Adicinar imagens, n camp Imagens para gerar PDF. 4. Selecine a imagem que tem nme crrespndente a parâmetr de imagem d template. 15 / 31
5. Clique n btã Salvar. O uplad de imagem é uma extensã da funcinalidade Uplad de template PDF. Ou seja, é necessári que, antes de inserir imagens a template PDF, seja selecinad um template JRXML. Para maires infrmações acesse: Uplad d Template PDF. Observaçã O uplad de imagem nã é brigatóri. Para ter mais de uma imagem n template PDF, é necessári ter mais de um parâmetr de imagem n arquiv JRXML. Template XML Arquiv XML Parametrizad Antes de explicarms a estrutura d arquiv XML parametrizad, vcê deve saber que: O XML descreve cnteúd d dcument e pssibilita estruturar, armazenar e enviar infrmaçã. A estrutura básica d XML é cmpsta pr tags e atributs, cada tag inicial tem uma tag final. E essas tags nã sã pré-definidas, u seja, vcê deve criar suas próprias tags. Td dcument XML pssui uma tag principal (um element raiz). As demais tags devem estar dentr dessa tag principal. As tags sã case-sensitive (diferencia letras maiúsculas e minúsculas.) O arquiv XML que será usad cm template XML, também deve pssuir s parâmetrs que vcê deseja que sejam exibids quand certificad em XML fr gerad. Os parâmetrs sã descrits da seguinte frma: ${NmeDParametr}. Exempl de um arquiv XML cm Parâmetrs: A primeira linha d dcument é uma declaraçã XML que deve sempre ser incluída. Ela define a versã XML d dcument e a cdificaçã de caracteres usada n dcument. N nss exempl, dcument está cnfrme a especificaçã 1.0 da XML e usa a cdificaçã UTF-8 Unicde: 16 / 31
A segunda linha crrespnde a principal tag d nss dcument, u seja, é element raiz d dcument. É cm se infrmasse tema d dcument. Um dcument XML deve cnter apenas um únic element raiz, que cnterá tds s utrs elements filhs d dcument. Tag principal usada exempl acima: As demais tags d dcument estã especificand quais sã s parâmetrs d template através $ {NmeDParametr}. O que está dentr das chaves ${ } sã s nmes ds parâmetrs definids n Template.: Parâmetrs d Template: ${PesNme}, ${LcalCurs}, ${CargaHrariaCursada}, $ {NmeOrgaEmissr}, ${Decanat}, ${MdalidadeCurs}, ${DataInicialCurs}, ${DataFinalCurs}, $ {CargaHrariaTtal} e ${EmentaCurs}. A última linha é a tag final d dcument. Cnfrme infrmad a cima, tda tag inicial deve ter uma tag final. A tag final é indicada pr uma barra / antes d nme da tag. A última linha define fim d element raiz: Uplad d template XML Para gerar Certificad de Cnclusã n frmat XML, é necessári que seja feit uplad de um arquiv text parametrizad e n frmat XML. Assim cm arquiv JRXML, s parâmetrs brigatóris que cnstam n arquiv XML deverã ser infrmads na slicitaçã de assinatura de certificads de cnclusã. Uplad d XML d template: 1. Acine menu Entidades > Template de Diplma. 2. Clique n btã Criar nv Template. 3. Clique em Adicinar XML, n camp XML. 4. Selecine arquiv XML desejad. 5. Clique n btã Salvar. Observações Para efetuar uplad d template XML, é necessári que já tenham sid selecinad um arquiv JRXML para uplad d Template PDF. Para maires infrmações de cm criar um arquiv XML parametrizad acesse a seçã Arquiv XML Parametrizad. 17 / 31
O template XML deve utilizar a Cdificaçã de caracteres UTF-8. Adiçã de Fnte de PDF N C3Web, pde-se adicinar fntes para geraçã de um certificad em PDF. A adiçã de fntes prmve a custmizaçã de um certificad que faça us de fntes que nã sejam padrões d sistema. As fntes de text, que nã frem padrã d Jasper Reprt, definidas n JRXML d certificad de cnclusã de curs precisam ser previamente cnfiguradas n sistema. Adicinar Fnte n IReprt Para adicinar uma fnte a um JRXML n IReprt siga s seguintes passs: 1. Pré-Requisits Arquiv da fnte(.ttf) desejada; Ferramenta ireprt instalada na máquina. 2. Incluind uma nva fnte n ireprt Acesse a tela cnfiguraçã d ireprt, especificamente a aba de fntes Ferramentas Opções Fnts; Clique em Install Fnt; 18 / 31
Clique em Brwse para selecinar caminh da fnte e clique em Next; 19 / 31
Marque a fnte cm send embutível num PDF; Crie um nv relatóri e teste sua nva fnte. 20 / 31
Exprtar Fnte d IRprt 1. Vlte para a tela de cnfigurações Ferramentas Opções Fnts. Selecine sua fnte e clique em Exprt as extensin; 21 / 31
2. Esclha caminh e nme para a sua fnte à ser exprtada. Adicinar Fnte a Prjet 1. Selecine e extraia arquiv.war; 2. Cpie arquiv.jar da sua nva fnte para dentr da pasta WEB-INF lib; 3. Zip a pasta nvamente para um arquiv.war cm mesm nme d arquiv anterir. Autenticaçã de Web Service Cadastrar Tken de Acess N C3Web, cnsum de infrmações através de serviçs web services sã realizads pr prtcl segur SSL, cm a utilizaçã de certificad para cnexã, e também, há a verificaçã de autrizaçã de cnsum de infrmações pr um códig de autenticidade, infrmad na requisiçã d serviç. Esse códig é chamad de Tken de Acess e é gerad pel sistema. Cadastrar um Tken de Acess: 1. Acine menu Entidades > Tkens de Acess. 2. Clique n btã Criar nv Tken de Acess. 3. Infrme a descriçã desejada. 4. Clique n btã Salvar. 22 / 31
Observaçã O Tken de Acess gerad é infrmad smente após cadastr. Nã é pssível recuperá-l após cadastr. Listar e Inativar Tken de Acess 1. Acine menu Entidades > Tkens de Acess. 2. Vcê deve cnseguir visualizar uma lista cm tds s tkens cadastrads. 3. Clique n btã Inativar. Observações Quand um Tken de Acess é desativad, qualquer web service que tente cnsumir um serviç cm este tken nã será autrizad. Um Tken de Acess pde ser nvamente ativad após ser desativad. Manual d Supervisr Prcess de Emissã ds Certificads Caixa de Trabalh d Supervisr As tarefas que Supervisr deve cumprir n prcess de emissã d certificad, estarã na suas Tarefas, quand submeter uma slicitaçã de assinatura de um lte de certificads. As tarefas sã exibidas em uma lista que cntém as seguintes infrmações: Nme, Situaçã, Data de Criaçã e a açã Visualizar. Cas Supervisr aprve lte, a tarefa para que ele seja assinad será exibida na Caixa de trabalh d Signatári. Para acessar a caixa de trabalh d Supervisr, vcê deve acessar sistema cm um certificad crrespndente a perfil e acinar menu "Supervisã > Pendências". Visualizar e Aprvar Prcess de Emissã Para visualizar s Prcesss de Emissã válids, é necessári que vcê acesse as tarefas dispníveis na sua Caixa de trabalh. O sistema exibirá uma lista cm as tarefas e a pçã para visualizá-la. Durante a visualizaçã d Prcess de Emissã serã exibidas as seguintes infrmações: Descriçã: Sã exibidas as seguintes infrmações referentes a Prcess de Emissã selecinad: Nme d lte, Data de criaçã, Enviad via, Situaçã e URL de respsta e cancelament. Históric: Cas Prcess pssua algum históric, sistema exibe uma tabela cntend Cmentári, Data e Hra e Respnsável. Requisições de Certificads: O sistema exibe uma lista de Requisições de Certificads, cntend as infrmações ds aluns que estavam n lte que crrespnde a Prcess de Emissã e que fram prcessads para ter certificad assinad e emitid. Para cada entrada da listagem (alun) sã dispnibilizadas as pções para realizar dwnlad d certificad em PDF e XML. Após a visualizaçã e a validaçã ds dads d lte vcê pde aprvá-l para dar cntinuidade a Prcess de Emissã ds Certificads: 23 / 31
Aprvar Prcess de Emissã: 1. Acine menu Supervisã > Pendências. 2. Clique n ícne Visualizar, crrespndente a tarefa que deseja visualizar as infrmações. 3. Visualize s dads desejads em "Descriçã, Históric e Requisições de Certificads. 4. Acine btã Aprvar. 5. Clique em Cnfirmar para cnfirmar aprvaçã d lte. O lte cm as requisições de certificads é aprvad e encaminhad para que primeir Signatári respnsável assine. Visualizar Certificad em PDF e XML Durante a visualizaçã d Prcess de Emissã ds Certificads, Supervisr pde visualizar PDF e XML ds certificads que serã gerads. Na aba Requisições de Certificads sistema exibe uma lista de Requisições de Certificads, para cada requisiçã da listagem estã dispníveis as pções para dwnlad d PDF e d XML. Dwnlad d Certificad em XML e PDF: Observaçã 1. Acine menu Supervisã > Pendências. 2. Clique n ícne Visualizar, crrespndente a tarefa que deseja visualizar as infrmações. 3. Clique n ícne XML. 4. Abra arquiv XML que fi transferid para sua máquina para visualizá-l. 5. Clique n ícne PDF. 6. Abra arquiv PDF que fi transferid para sua máquina para visualizá-l. Os Parâmetrs d Sistema só serã exibids ns Certificads após a aprvaçã d Lte pel Supervisr. Supervisã das Emissões ds Certificads Listar e Visualizar Prcess de Emissã Para visualizar s Prcesss de Emissã cmplets e em andament, é necessári seguir s seguintes passs: 1. Acesse menu Supervisã > Requisições de Diplmas. 2. Clique em Visualizar para Prcess de Emissã desejad. O sistema exibirá a tela de visualizaçã de certificad. A qual cntém s seguintes dads: Descriçã: Sã exibidas as seguintes infrmações referentes a Prcess de Emissã selecinad: Nme, Data de criaçã, Situaçã, "URL de respsta, URL de cancelament, Origem, Históric e Diplmas. Históric: Cas Prcess pssua algum históric, sistema exibe um camp cntend Cmentári, Data e Hra e Respnsável. 24 / 31
Requisições de Certificads: O sistema exibe uma lista de Requisições de Certificads, cntend as infrmações ds aluns que estavam n lte que crrespnde a Prcess de Emissã e que fram prcessads para ter certificad assinad e emitid. Para cada entrada da listagem (alun) sã dispnibilizadas as pções para realizar dwnlad d certificad em PDF e XML. Enquant Prcess de Emissã nã huver sid cncluíd, Supervisr pderá cancelá-l. Para realizar tal açã, basta clicar n btã Cancelar, na caixa acima ds dads d prcess, e cnfirmar cancelament. Cancelar Prcess de Emissã 1. Acesse menu Supervisã > Requisições de Diplmas. 2. Clique em Visualizar para Prcess de Emissã desejad. O sistema exibirá a tela de visualizaçã de certificad. A qual cntém s seguintes dads: Descriçã: Sã exibidas as seguintes infrmações referentes a Prcess de Emissã selecinad: Nme, Data de criaçã, Situaçã, "URL de respsta, URL de cancelament, Origem, Históric e Diplmas. Históric: Cas Prcess pssua algum históric, sistema exibe um camp cntend Cmentári, Data e Hra e Respnsável. Requisições de Certificads: O sistema exibe uma lista de Requisições de Certificads, cntend as infrmações ds aluns que estavam n lte que crrespnde a Prcess de Emissã e que fram prcessads para ter certificad assinad e emitid. Para cada entrada da listagem (alun) sã dispnibilizadas as pções para realizar dwnlad d certificad em PDF e XML. 3. Clique n btã Cancelar acima das infrmações d lte. 4. Cnfirmar cancelament d lte Observaçã A pçã Cancelar só será exibida a um lte cuj Prcess de Emissã nã huver sid Finalizad. Cancelar Certificad 1. Acesse menu Supervisã > Requisições de Diplmas. 2. Clique em Visualizar para Prcess de Emissã desejad. O sistema exibirá a tela de visualizaçã de certificad. A qual cntém s seguintes dads: Aba Descriçã: Sã exibidas as seguintes infrmações referentes a Prcess de Emissã selecinad: Nme, Data de criaçã, Situaçã, "URL de respsta, URL de cancelament, Origem, Históric e Diplmas. Históric: Cas Prcess pssua algum históric, sistema exibe um camp cntend Cmentári, Data e Hra e Respnsável. Requisições de Certificads: O sistema exibe uma lista de Requisições de Certificads, cntend as infrmações ds aluns que estavam n lte que crrespnde a Prcess de Emissã e que fram prcessads para ter certificad assinad e emitid. Para cada entrada da listagem (alun) sã dispnibilizadas as pções para realizar dwnlad d certificad em PDF e XML. 3. Clique em Cancelar para Certificad da lista desejad. 25 / 31
4. Cnfirmar cancelament d certificad. Observaçã A pçã Cancelar só será exibida para Certificads que pertençam a um lte cuj Prcess de Emissã huver sid Finalizad. Manual d Operadr Template Uplad d Template PDF O template PDF é utilizad para cnfigurar a aparência ds certificads de cnclusã que serã gerads. Para criar um Template, é necessári que vcê faça uplad de um arquiv text cm esquema JRXML, esse arquiv deve cnter a estrutura ds certificads que serã emitids n frmat PDF. Os parâmetrs definids n arquiv JRXML devem ser infrmads na slicitaçã de assinatura em lte de certificads. Adicine arquiv XML e as imagens para gerar PDF. 1. Acine menu Administraçã > Templates de Diplma. 2. Clique n btã Criar nv Template. 3. Preencha camp Nme (brigatóri). 4. Adicine arquiv JRXML, clicand em Adicinar JRXML (brigatóri). 5. Adicine arquiv XML, clicand em Adicinar XML (brigatóri). 6. Adicine as imagens para gerar PDF, clicand em Adicinar imagem. 7. Clique n btã Salvar. Observações O template PDF deve utilizar a Cdificaçã de caracteres UTF-8. Para salvar template JRXML, é necessári que tenham sid selecinadas as imagens (se tiver) e um arquiv XML. Parâmetr de Imagem n Template PDF Quand huver a necessidade de que s certificads gerads pssuam imagens, será precis criar template PDF cm parâmetr de imagem. A seguir auxiliarems a criar template PDF cm parâmetr de imagem utilizand a ferramenta ireprt. O ireprt é uma ferramenta gratuita que pssibilita criar template PDF e é amplamente utilizada em desenvlviment de sistemas. Ela gera um arquiv cm extensã.jrxml nde é descrit a estrutura d arquiv PDF e s parâmetrs d certificad. Dwnlad e Instalaçã d ireprt: O ireprt está dispnível n site http://ireprt.surcefrge.net. A sua instalaçã é padrã (dupl clique e nexts). Criand template n ireprt: Após a instalaçã d ireprt vcê pde criar template cnfrme desejad. Para mais infrmações de cnfiguraçã e criaçã d template através d ireprt acesse: https://cmmunity.jaspersft.cm/wiki/designing-reprt. 26 / 31
Incluind parâmetr de imagem n template: Pdems incluir n template PDF s parâmetrs que desejams que sejam exibids quand certificad fr gerad: 1. Abra template PDF cm a extensã.jrxml pel ireprt. 2. Lcalize n lad esquerd da ferramenta a aba Reprt Inspectr. 3. Clique cm btã direit d muse em Parameters e em Adicinar Parameter. 4. Selecine parâmetr criad e lcalize d lad direit da tela a aba Prpriedades. 5. Na aba prpriedades, altere nme d parâmetr na seçã Name. 6. Esclha a classe d parâmetr java.i.inputstream na seçã Parameter Class. Obs.: Inicialmente vai estar selecinada a pçã java.util.string. 7. Ative a paleta d ireprt através d cmand Crtl+Shitf+8. 8. Clique e arraste para dcument ícne Image dispnível na paleta. É exibida uma tela de seleçã de arquivs. 27 / 31
9. Selecine uma imagem u cancele a peraçã de seleçã d arquiv. Obs.: A imagem selecinada nã será exibida n template, prém, será exibida n dcument uma área retangular cm uma imagem default nde a imagem deverá ser renderizada. 10. Clique sbre element de imagem que vcê arrastu para dcument. 11. Lcalize d lad direit da tela a aba Prpriedades. 12. Na aba prpriedades, altere Expressin Class d element imagem para java.i.inputstream. 13. Clique n ícne... em Imagem Expressin. 14. Lcalize na listagem parâmetr criad n pass 4. 15. Clique duas vezes sbre ele para seleciná-l. 28 / 31
16. Após selecinad parâmetr clique em OK. O template PDF pssui agra parâmetr de imagem. Quand arquiv fr dispnibilizad n C3Web e as imagens frem selecinadas para template, essas imagens deverã crrespnder a nme ds parâmetrs de imagem criads. Observaçã Lembre-se de infrmar, n pass 5, nme d parâmetr de imagem cm a extensã. Ex.: $P{MinhaImagem.png}. Onde nme da imagem é MinhaImagem e a extensã png. Uplad de Imagens para PDF Para definir quais imagens irã cmpr certificad, é precis incluí-las n Template de acrd cm parâmetr de imagem criad n arquiv JRXML. As imagens deverã ter a extensã JPG, JPEG u PNG e pssuir mesm nme d parâmetr de imagem utilizad template PDF ( arquiv JRXML). Uplad de Imagens: 1. Acine menu Entidades > Template de Diplma. 2. Clique n btã Criar nv Template. 3. Clique n btã Adicinar imagem, n camp Imagens para gerar PDF. 29 / 31
4. Selecine a imagem que tem nme crrespndente a parâmetr de imagem d template. 5. Clique n btã Salvar. O uplad de imagem é uma extensã da funcinalidade Uplad de template PDF. Ou seja, é necessári que, antes de inserir imagens a template PDF, seja selecinad um template JRXML. Para maires infrmações acesse: Uplad d Template PDF. Observaçã O uplad de imagem nã é brigatóri. Para ter mais de uma imagem n template PDF, é necessári ter mais de um parâmetr de imagem n arquiv JRXML. Manual d Signatári Prcess de Emissã ds Certificads Caixa de Trabalh e Tarefas Pendentes Tdas as Tarefas d Signatári que estã pendentes sã exibidas em suas Pendências. Quand Supervisr aprvar lte para assinatura que fi submetid n sistema, será exibida uma lista de Tarefas pendentes na Caixa de Trabalh d Signatári respnsável, essa lista terá as seguintes infrmações: Nme d lte, Situaçã, Data de Criaçã e a pçã para Iniciar. A Tarefa de assinatura pendente só estará dispnível na Caixa de Trabalh d segund Signatári, após primeir Signatári respnsável realizá-la e assim sucessivamente. Para acessar sua Caixa de Trabalh d Signatári, vcê deve lgar n sistema cm um certificad crrespndente a perfil e acinar menu "Signatári > Pendências". Visualizar Tarefas Pendentes O Signatári pde visualizar suas Tarefas pendentes através ds Certificads para Assinar, para acessá-la basta estar lgad n sistema utilizand perfil de Signatári e acinar menu Signatári > Pendências. O sistema exibe a lista de tarefas e a pçã para Assinar, que permite a visualizaçã d lte. Durante a visualizaçã da tarefa serã exibidas infrmações referentes a lte que crrespnde a tarefa e infrmações referentes a prcess de emissã ds certificads d lte. Essas infrmações estã rganizadas da seguinte frma: Descriçã: Sã exibidas as seguintes infrmações referentes à Tarefa selecinada: Nme, Data de criaçã, Situaçã, "URL de respsta, URL de cancelament, Origem, Históric e Diplmas. Históric: Cas Prcess pssua algum históric, sistema exibe um camp cntend Cmentári, Data e Hra e Respnsável. Requisições de Certificads: O sistema exibe uma lista de Requisições de Certificads cntend as infrmações ds Aluns que estavam n lte que crrespnde a Prcess de Emissã e que fram prcessads para ter certificad assinad e emitid. Para cada entrada da listagem sã dispnibilizadas as pções para realizar dwnlad d certificad em PDF e XML. 30 / 31
Visualizar Tarefas Pendentes: 1. Acine a pçã de menu Signatári > Pendências. 2. Clique n ícne Assinar, crrespndente a tarefa que deseja visualizar as infrmações. 3. Visualize s dads desejads em "Descriçã, Históric e Requisições de Certificads. Visualizar Certificads em PDF e XML Durante a Visualizaçã das Tarefas Pendentes, Signatári pde visualizar s certificads que serã emitids ns frmats PDF e XML. Cada certificad que será emitid está dispnível na listagem de Requisições de Certificads cm as pções para Dwnlad d PDF e d XML. Dwnlad d Certificad em XML e PDF: 1. Acine menu Signatári > Pendências. 2. Clique n ícne Assinar, crrespndente a tarefa que deseja visualizar as infrmações. 3. Na listagem, clique n ícne XML. 4. Abra arquiv XML que fi transferid para sua máquina para visualizá-l. 5. Na listagem, clique n ícne PDF. 6. Abra arquiv PDF que fi transferid para sua máquina para visualizá-l. Assinar lte de Certificads Após a aprvaçã d Lte de Requisiçã de Assinatura pel Supervisr, s Signatáris respnsáveis deverã efetuar a assinatura d Lte para que Prcess de Emissã seja cncluíd. Smente após tds s Signatáris respnsáveis realizarem a assinatura d lte é que s Certificads de Cnclusã serã emitids para s Aluns. Quand huver pendências de assinatura ds Certificads s Signatáris respnsáveis serã ntificads pel e-mail. A assinatura d Lte de requisiçã está dispnível na Visualizaçã das Tarefas Pendentes e para assinar lte Signatári deve selecinar seu Certificad Digital e infrmar a senha d mesm: 1. Acine menu Signatári > Pendências. 2. Clique n ícne Assinar, crrespndente a tarefa que deseja visualizar as infrmações. 3. Clique n btã Cnfigurar. 4. Selecine seu Certificad Digital válid. 5. Clique n btã Assinar. 6. Infrme a senha d seu Certificad Digital. Cas a assinatura seja válida, sistema exibirá uma mensagem de sucess e s Certificads serã assinads. Observaçã A assinatura só pderá ser visualizada ns Certificads gerads em XML. E assinatura ds mesms será feita n padrã Xades. 31 / 31