ỨNG DỤNG OPEN BADGES

Trong lĩnh vực giáo dục, ngày càng có nhiều trường học và cao đẳng cấp huy hiệu kỹ thuật số để giúp sinh viên của họ thể hiện các kỹ năng, thành tích, phẩm chất nhằm công khai với các nhà tuyển dụng tiềm năng hoặc các chương trình sau đại học.

Ngoài ra, các tổ chức cũng đang tìm kiếm các dịch vụ tùy chỉnh, được gắn nhãn trắng để động viên và thúc đẩy tinh thần của nhân viên thông qua các huy hiệu kỹ thuật số trong Teams. Open badges cho phép các tổ chức này mang lại trải nghiệm tùy chỉnh và có thương hiệu như vậy cho nhân viên của họ.

Ứng dụng Open Badges sẽ cho phép các cá nhân mang theo việc học của họ ở bất cứ đâu, xây dựng bức tranh phong phú về hành trình học tập suốt đời của họ bằng cách tận dụng các khả năng từ cơ quan cấp huy hiệu kỹ thuật số bên thứ ba có tên là Badgr.

Sử dụng mẫu ứng dụng Open Badges trong các nhóm của Microsoft, Người dùng có thể tạo và trao huy hiệu cho các thành viên trong nhóm ngay trong ngữ cảnh của Teams. Khi huy hiệu được trao, người nhận và các thành viên khác trong nhóm sẽ được thông báo về chi tiết huy hiệu được trao trong kênh bằng cách gắn thẻ họ trong cuộc trò chuyện trên kênh. Tất cả các thành viên trong nhóm sẽ có thể chọn huy hiệu từ danh sách các huy hiệu có sẵn và trao cho nhau, trong khi chỉ chủ sở hữu Team mới có thể tạo huy hiệu mới.

Các huy hiệu được trao được ghi lại trong hồ sơ Badgr của người nhận, nó an toàn, di động và dễ dàng chia sẻ.

Hướng dẫn triển khai

Điều kiện tiên quyết

Để bắt đầu, bạn sẽ cần:

  • Tài khoản người dùng để đăng nhập trang Badgr website  (tốt nhất là tài khoản dịch vụ hỗ trợ email vì nó sẽ được sử dụng tiếp với tư cách chủ sở hữu).
  • Đăng ký Azure nơi bạn có thể tạo các loại tài nguyên sau:

+ App service

+ App service plan

+ Đăng ký kênh bot

+ Azure Key Vault

+ Thông tin chi tiết về ứng dụng

+ Bản sao repo ứng dụng Badgr GitHub URL

Bước 1: Thiết lập đăng ký Badgr

  1. Tài khoản người dùng để đăng nhập Badgr website
  2. Nếu đây là lần đầu tiên bạn thiết lập tài khoản trong Badgr, vui lòng Đăng ký
  3. Đăng nhập vào Badgr website bằng tài khoản người dùng (còn gọi là siêu người dùng)
  4. Sau khi đăng nhập thành công, vui lòng chuyển đến menu Issuer và thêm Create new issuer. Để được trợ giúp thêm, vui lòng tham khảo tại đây refer
  5. Vui lòng thêm thông tin chi tiết trong biểu mẫu Issuer

+ Name (ví dụ: Đại học Fabrikam). Vui lòng đảm bảo rằng tên nhà phát hành chưa được sử dụng trước đó để tránh xung đột không mong muốn.

+ Website URL (for e.g. https://www.fabrikam.com/)

+ Contact Email – vui lòng chọn cùng một tài khoản email mà bạn đã đăng ký

+ Description- Thêm mô tả nhóm của bạn

+ Vui lòng đọc chính sách và nhấp vào Create Issuer

  • Vui lòng sao chép tên của Issuer vì tên này sẽ được sử dụng ở các bước sau
  • Chúng tôi khuyên bạn nên create few badges sau bước này. Những huy hiệu này sẽ khả dụng cho tất cả người dùng trong công ty của bạn sau khi họ đăng nhập qua ứng dụng Open Badges teams. – mẹo: Vui lòng tải lên hình ảnh huy hiệu thay vì hình ảnh ngẫu nhiên
  • Client Id và client secret từ Badgr (hướng dẫn mới nhất tại đây here)
  • Để có được client id và client secret, vui lòng gửi email đến nhóm hỗ trợ Badgr với các chi tiết sau

+ Địa chỉ mail:  [email protected]

+ Subject: Id khách hàng và bí mật cho ứng dụng Microsoft Teams Open Badges

+ Body: Vui lòng đảm bảo thêm thông tin bên dưới vào email

  • Badgr account email
  • Redirect URL – https://token.botframework.com/.auth/web/redirect
  • Website URL – https://open-badges-{yourcompanyname}.azurewebsites.net  (hãy đảm bảo sử dụng cùng một URL mà bạn đang dự định triển khai)
  • Service name
  • Logo ứng dụng (tùy chọn)
  • URL chính sách bảo mật của tổ chức của bạn
  • URL điều khoản dịch vụ của tổ chức của bạn

+ Nhóm hỗ trợ Badgr sẽ hoàn nguyên trong vòng 2-3 ngày làm việc với liên kết để truy cập thông tin mật và id khách hàng

+ Vui lòng sao chép và lưu id khách hàng và bí mật vì nó sẽ được sử dụng trong khi thiết lập xác thực ở các bước sau

+ Vào lúc này, bạn sẽ có các chi tiết sau:

  • Tài khoản người dùng và mật khẩu của chủ sở hữu Issuer
  • Tên Issuer

Bước 2: Đăng ký ứng dụng Azure Active Directory

  1. Mở bảng Azure Active Directory trong cổng Azure. Nếu bạn không ở đúng đối tượng thuê, hãy nhấp vào Switch directory để chuyển sang đúng đối tượng thuê. 
  2. Mở bảng App registrations
  3. Trong bảng App registrations, nhấp vào New registration.
  4. Điền vào các trường bắt buộc và tạo đăng ký ứng dụng.
  5. Đặt tên cho ứng dụng của bạn – nếu bạn đang làm theo mẫu cho triển khai mặc định, chúng tôi khuyên bạn nên ” Open Badges “.
  6. Chọn Supported account type là Accounts in any organizational directory.
  • Đối với Redirect URI
  • Chọn Web
  • Đặt URL thành https://token.botframework.com/.auth/web/redirect.
  • Nhấp vào Register
  • Khi nó được tạo, Azure hiển thị trang Overview cho ứng dụng.
  • Ghi lại giá trị Application (client) ID. Bạn sẽ sử dụng giá trị này sau này làm Client ID khi đăng ký ứng dụng Microsoft Azure Active Directory với bot của bạn.
  • Đồng thời ghi lại giá trị Directory (tenant) ID. Bạn cũng sẽ sử dụng nó để đăng ký ứng dụng này với bot của bạn.
  • Trong ngăn dẫn hướng, bấm Certificates & secrets để tạo bí mật cho ứng dụng của bạn.
  • Trong Client secrets, bấm New client secret.
  • Thêm mô tả để xác định bí mật này từ những người khác mà bạn có thể cần tạo cho ứng dụng này, chẳng hạn như đăng nhập bằng bot.
  • Đặt Expires thành Never
  • Nhấp vào Add
  • Trước khi rời khỏi trang này, hãy ghi lại bí mật. Bạn sẽ sử dụng giá trị này sau này làm Client secret khi đăng ký ứng dụng Microsoft Azure Active Directory với bot của bạn.

Bây giờ bạn đã đăng ký một ứng dụng trong Microsoft Azure Active Directory.

Bước 3: Triển khai đăng ký Azure của bạn

  1. Nhấp vào nút ” Deploy to Azure ” bên dưới.
  • Khi được nhắc, hãy đăng nhập vào Azure subscription.
  • Azure sẽ tạo một ” Custom deployment ” dựa trên mẫu ARM và yêu cầu bạn điền vào các thông số của mẫu.
  • Chọn đăng ký và resource group.
  • Chúng tôi khuyên bạn nên tạo một resource group mới.
  • Vị trí resource group PHẢI nằm trong trung tâm dữ liệu hỗ trợ: Application Insights; Key Vault. Để có danh sách cập nhật, hãy nhấp vào đây here, và chọn khu vực có các dịch vụ sau:

+ Application Insights

+ Key Vault

  • Nhập ” Base Resource Name “, mẫu sử dụng để tạo tên cho các tài nguyên khác.
  • Tên dịch vụ ứng dụng [Base Resource Name] phải có sẵn. Ví dụ: nếu bạn chọn Open Badges làm tên cơ sở, tên Open Badges phải có sẵn (không được lấy); nếu không, việc triển khai sẽ không thành công với lỗi Conflict.
  • Nhớ tên tài nguyên cơ sở mà bạn đã chọn. Chúng tôi sẽ cần nó sau.
  • Điền vào các ID khác nhau trong mẫu:
    • Bot client ID: ID ứng dụng (ứng dụng khách) của ứng dụng bot Microsoft Teams
    • Bot client secret: client secret của ứng dụng bot Microsoft Teams
    • Tenant ID: Tenant ID nơi ứng dụng được lưu trữ (từ bước 2)
    • Issuer entity name : Người dùng cần cung cấp tên pháp nhân nhóm Issuer (được tạo ở Bước 1)
    • Superuser username: Người dùng cần cung cấp id người dùng của chủ sở hữu nhóm issuer (Tài khoản chủ sở hữu được sử dụng ở Bước 1)
    • Superuser Password: Người dùng cần cung cấp mật khẩu chủ sở hữu nhóm phát hành (Mật khẩu tài khoản chủ sở hữu được sử dụng ở Bước 1)

Đảm bảo rằng các giá trị được sao chép nguyên trạng, không có khoảng trắng thừa. Mẫu kiểm tra GUID có chính xác 36 ký tự không.

  • Nếu bạn muốn thay đổi tên, mô tả và biểu tượng ứng dụng từ mặc định, hãy sửa đổi các thông số mẫu tương ứng.
  • Đồng ý với các điều khoản và điều kiện của Azure bằng cách nhấp vào hộp kiểm “I agree to the terms and conditions stated above” nằm ở cuối trang.
  • Nhấp vào “Purchase” để bắt đầu triển khai.
  • Chờ cho quá trình triển khai kết thúc. Bạn có thể kiểm tra tiến trình triển khai từ ngăn “Notifications” của Cổng Azure. Có thể mất đến 20 phút để quá trình triển khai kết thúc.
  • Khi quá trình triển khai kết thúc, bạn sẽ được dẫn đến một trang có các trường sau:
  • BotId – Đây là Microsoft Application ID cho Open Badges.
  • AppDomain – Đây là miền cơ sở cho các Open Badges.

Bước 4: Thiết lập xác thực cho bot

  1. Lưu ý tên của bot mà bạn đã triển khai, đó là [BaseResourceName].
  2. Truy cập cổng thông tin azure tại đây  here và tìm kiếm bot của bạn.
  3. Nhấp vào bot trong danh sách ứng dụng. Trong phần ” Settings”, nhấp vào ” Add Setting”.
  4. Điền vào biểu mẫu như sau:
  5. Đối với Name, hãy nhập “BadgrAuth”. Bạn sẽ sử dụng nó trong mã bot của mình.
  6. Đối với Service Provider, hãy chọn Generic Oauth 2.
  7. Đối với Client ID, hãy nhập application (client) ID mà nhóm Badgr đã cung cấp.
  8. Đối với Client secret, hãy nhập bí mật mà bạn đã nhận được từ nhóm Badgr.
  9. Đối với Authorization URL, hãy sử dụng  https://badgr.io/auth/oauth2/authorize
  10. Đối với Token URL, hãy sử dụng https://api.badgr.io/o/token
  11. Để Refresh URL, hãy sử dụng https://api.badgr.io/o/token
  12. Đối với Scopes, hãy nhập tên của quyền bạn đã chọn khi đăng ký ứng dụng: rw:backpack rw:profile rw:issuer
  13. Nhấp vào Save.

Bước 5: Tạo gói ứng dụng Teams

Tạo gói ứng dụng Teams:

  1. Mở tệp Manifest \ manifest.json trong trình soạn thảo văn bản.
  2. Thay đổi các trường placeholder trong tệp kê khai thành các giá trị thích hợp cho tổ chức của bạn.
  3. developer.name
  4. developer.websiteUrl
  5. developer.privacyUrl
  6. developer.termsOfUseUrl
  7. Thay đổi << botId>> placeholder cho ID ứng dụng Azure Active Directory của bạn từ bên trên. Đây là GUID giống như bạn đã nhập vào mẫu trong ” Bot Client ID “.
  8. Trong phần “validDomains”, hãy thay thế <<appDomain>> với miền của bot App Service của bạn. Đây sẽ là [BaseResourceName] .azurewebsites.net. Ví dụ: nếu bạn chọn “contosoBadgr” làm tên cơ sở, hãy thay đổi placeholder thành contosoBadgr.azurewebsites.net.
  • Tạo gói ZIP với tệp manifest.json, color.png và outline.png. Hai tệp hình ảnh là biểu tượng cho ứng dụng của bạn trong Teams.
  • Đặt tên cho gói này là OpenBadges.zip.
  • Đảm bảo rằng 3 tệp là cấp cao nhất của gói ZIP, không có thư mục lồng nhau.

Bước 6: Chạy các ứng dụng trong Microsoft Teams

  1. Nếu tenant của bạn đã bật ứng dụng tải xuống, bạn có thể cài đặt ứng dụng của mình bằng cách làm theo hướng dẫn tại đây here
  2. Bạn cũng có thể tải nó lên danh mục ứng dụng của tenant để mọi người trong tenant của bạn có thể cài đặt.
  3. Cài đặt ứng dụng end-user (gói OpenBadges.zip) cho người dùng của bạn.

Tổng quan về giải pháp

Tích hợp badgr

  • Ứng dụng sử dụng các API Badgr để xác thực người dùng và quản lý badges người dùng
  • Badgr tuân theo cơ chế xác thực OAuth2.0 cũng được hỗ trợ bởi các nhà cung cấp kết nối Azure bot OAuth.
  • Ứng dụng kết nối với kho chìa khóa Azure để truy cập chi tiết tài khoản chủ sở hữu Badgr (khuyến nghị sử dụng tài khoản dịch vụ có quyền chủ sở hữu trong nhóm nhà phát hành).

Mẫu ứng dụng Open Badges tích hợp với trang Badgr để cung cấp khả năng tạo huy hiệu trong Microsoft Teams, trao tặng cho các thành viên trong nhóm và xem các huy hiệu đã nhận được. Nó có đặc điểm sau

  1. Owner- có thể thêm / xóa thành viên và huy hiệu cùng với việc trao huy hiệu cho các thành viên
  2. Editor- có thể tạo huy hiệu và trao huy hiệu cho người dùng.
  3. Staff members – có thể xem và trao các huy hiệu được cung cấp trong nhóm công ty phát hành

Giải pháp Azure

  • Dịch vụ ứng dụng triển khai trải nghiệm Bot bằng cách cung cấp end points cho giao tiếp của người dùng. Dịch vụ ứng dụng lưu trữ ứng dụng phản ứng để Trao thưởng và liệt kê các huy hiệu của người dùng trong mô-đun nhiệm vụ.
  • App endpoint được đăng ký làm điểm cuối nhắn tin trong cổng đăng ký bot và cung cấp điểm cuối / api / tin nhắn để xử lý yêu cầu / phản hồi của bot.
  • App service lưu trữ ứng dụng React cho mô-đun tác vụ và cung cấp các API tùy chỉnh ở phía sau để gọi API.
  • Các mô-đun tác vụ dựa trên HTML được ủy quyền bằng cách sử dụng JWT tùy chỉnh do ứng dụng tạo bằng id người dùng, URL dịch vụ và các khóa ký duy nhất.
  • Badgr: Ứng dụng sử dụng các API Badgr REST để hiển thị và trao huy hiệu. Tất cả các lệnh gọi API được thực hiện từ phần phụ trợ dịch vụ ứng dụng bằng cách sử dụng mã thông báo truy cập.
  • Ứng dụng liệt kê các thành viên trong nhóm từ danh sách để chọn các thành viên trong nhóm trong khi trao huy hiệu

Bài viết thuộc về: www.office365vietnam.info

Ý kiến của bạn:

This site uses Akismet to reduce spam. Learn how your comment data is processed.