Visão geral
Este documento tem como objetivo orientar os usuários sobre como integrar o servidor Central Authentication Service (CAS) de sua organização como sistema de SSO para fazer login na plataforma de vídeo corporativa YuJa. Depois de configurado corretamente, um usuário que tentar acessar a plataforma de vídeo será redirecionado primeiro ao servidor CAS e solicitado a informar as credenciais. Depois de autenticado, será redirecionado de volta à plataforma de vídeo, onde será verificado e conectado.
Configuração
A configuração envolve autorizar a plataforma de vídeo a usar o servidor CAS. Depois de autorizada como serviço, a integração com a plataforma de vídeo inclui informar os parâmetros de configuração necessários e testar. A próxima etapa é ativar o novo SSO para que os usuários da sua instituição possam fazer login por meio da autenticação CAS.
Em algumas etapas, <organization> deve ser substituído pelo DNS curinga da instituição associada à plataforma de vídeo. Por exemplo, para “https://hudson.yuja.com”, <organization> seria substituído por “hudson”.
Autorizar a plataforma de vídeo como serviço no servidor CAS
- Acesse o Services Management Console (https://<CAS domain>/cas/services/) do servidor CAS, faça login e clique em Adicionar novo serviço.
- No campo Nome, insira YuJa.
- No campo URL do serviço, insira 'https://<organization>.yuja.com/D/CasHandleTicket' sem as aspas.
- No campo Descrição, insira uma descrição.
- Em Status, marque Ativado, Permitido como proxy e Participante de SSO. Não marque Acesso anônimo.
-
Em Atributos, os itens a seguir precisam ser fornecidos à plataforma de vídeo. Para cada atributo, anote o rótulo usado. Eles serão necessários ao configurar o lado da plataforma de vídeo.
- Nome principal (ou seja, nome de usuário)
- FirstName
- Sobrenome
- Função
- Clique em Salvar alterações.
Há três funções que o usuário da plataforma de vídeo pode ter: “Estudante”, “Instrutor” e “Gerente de TI”. Se os valores possíveis do atributo Função forem diferentes dessas 3 opções, informe todos os valores possíveis de Função à plataforma de vídeo, e eles serão mapeados para uma das três opções.
Configuração do CAS no lado da plataforma de vídeo
- Acesse a Zona da plataforma de vídeo da sua instituição e faça login como Gerente de TI.
- No Menu principal, localizado no canto superior direito, acesse a guia Painel de administrador.
- Na barra lateral esquerda, acesse Integrações.
- Em Selecione uma API para configurar, escolha SSO – CAS.
-
Insira os parâmetros de configuração:
- URL do servidor CAS: https://<CAS domain>/cas
- Para cada rótulo de atributo, insira os valores correspondentes que você anotou ao adicionar a plataforma de vídeo como serviço na seção intitulada Autorizar a plataforma de vídeo como serviço no servidor CAS.
- Clique em Criar.
- Clique em Ok na caixa de diálogo de confirmação.
- Se necessário, você pode atualizar as configurações caso tenha cometido algum erro. Basta clicar em Salvar para manter as alterações.
- Para testar se a configuração está correta, clique em Testar login CAS. Isso deve abrir uma nova guia e acessar o seu servidor CAS, solicitando o login.
- Faça login no seu SSO usando uma credencial de login válida.
- Você deve ser redirecionado de volta à plataforma de vídeo, conectado como um novo usuário. Fazer login como um novo usuário pode desconectar a conta original. Se isso acontecer, saia da conta recém-criada, faça login novamente como Gerente de TI e volte para Painel de administrador → Integrações → SSO – CAS.
- Depois de verificar que o SSO por CAS funciona, você pode ativar o novo esquema de autenticação para a sua instituição. Para isso, clique em Ativar e, em seguida, clique em Ok na caixa de diálogo de confirmação.
Ative o novo esquema de autenticação somente depois de realizar um login de teste com sucesso e quando estiver pronto para disponibilizá-lo a todos os usuários da sua instituição.
Integração dupla com LTI
Se a sua instituição habilitou tanto a integração com o LMS via LTI quanto o acesso por SSO, você pode vincular as duas integrações. Em geral, recomendamos isso, pois, independentemente de os usuários fazerem login pelo LMS ou pelo SSO, eles verão as mesmas informações de conta da plataforma de vídeo.
Em contrapartida, se a integração dupla com LTI não estiver configurada, um usuário que usa tanto o LMS quanto o SSO com a plataforma de vídeo receberá duas contas separadas, o que, em muitos casos, não é o ideal. Se o seu provedor de LTI no LMS puder ser configurado para fornecer à plataforma de vídeo um identificador exclusivo do usuário no sistema CAS, é possível vincular as duas contas.
- Configure o seu LMS para passar à ferramenta da plataforma de vídeo um parâmetro LTI personalizado chamado lis_person_sourcedid, que contém o valor de SSO usado para correspondência. Pode ser um e-mail, um ID de funcionário ou outro campo. Talvez seja necessário consultar a documentação do produto da sua plataforma de LMS sobre como definir parâmetros LTI personalizados. A plataforma de vídeo usará esse recurso para vincular os dois métodos de login à mesma conta.
- Obtenha o nome do atributo cujo valor corresponde ao identificador exclusivo usado pelo provedor de LTI.
- Insira esse valor no campo Atributo de ligação, como external. Este é o mesmo atributo encontrado no arquivo attribute-repository.json, localizado em C:\etc\cas no servidor CAS. Essa caixa de texto só aparecerá se a sua instituição tiver habilitado o acesso por LTI.
- Clique em Salvar integração cruzada.
- Agora, ao fazer login pela primeira vez via CAS, a plataforma de vídeo procurará um vínculo com uma conta LTI usando o valor do atributo de ligação. Se encontrar, a conta do CAS será vinculada à conta existente. Caso contrário, uma nova conta será provisionada normalmente. Todos os logins após o primeiro continuarão vinculados à conta da plataforma de vídeo criada ou encontrada no primeiro login.
Uso
Depois que a configuração for concluída tanto no servidor CAS quanto na plataforma de vídeo e o SSO por CAS tiver sido ativado, os usuários da sua instituição não serão mais autenticados pela plataforma de vídeo. Em vez disso, ao acessar a Zona da plataforma de vídeo da sua instituição e fazer login, eles serão redirecionados ao servidor CAS para autenticação e, depois de autenticados, redirecionados de volta à plataforma de vídeo.
Os administradores podem implementar um provedor CAS secundário. Para habilitar esse recurso, entre em contato com o seu gerente de conta.