Megosztás a következőn keresztül:


Univerzális nyomtató (UP) nyomtató ügyfélazonosító-regisztrációja

Az OEM-nyomtató ügyfélalkalmazás API-engedélyeinek megadása

A Universal Print támogatja az Azure által kiadott OAuth2 engedélyezési hozzáférési jogkivonatot. Univerzális nyomtatásra kész nyomtató fejlesztéséhez az OEM-nek regisztrálnia kell egy ügyfélalkalmazást az Azure-ban a szükséges engedélyekkel. Az OAuth2 kétféle engedélykérelmet határoz meg.

Delegált hatókör engedélyei

Scope Sztring megjelenítése Leírás Rendszergazdai hozzájárulás szükséges
Printers.Create Új nyomtató létrehozása és regisztrálása. Lehetővé teszi az alkalmazás számára, hogy nyomtatót hozzon létre és regisztráljon a bejelentkezett felhasználó nevében. Igen

Alkalmazás hatókörének engedélyei

Scope Sztring megjelenítése Leírás Rendszergazdai hozzájárulás szükséges
Printers.Read Olvassa el azokat a nyomtatókat, amelyekhez a fiók hozzáfér. Lehetővé teszi, hogy az alkalmazás bejelentkezett felhasználó nélkül olvassa be a nyomtatókat. Igen
PrinterProperties.ReadWrite A fiók által elérhető nyomtatótulajdonságok és attribútumok olvasása és írása. Lehetővé teszi, hogy az alkalmazás bejelentkezett felhasználó nélkül olvassa és írja be a nyomtató tulajdonságait és attribútumait. Igen
PrintJob.ReadWriteBasic A nyomtatási feladat metaadatainak olvasása és írása. Lehetővé teszi, hogy az alkalmazás bejelentkezett felhasználó nélkül olvassa és írja meg a felhasználók nyomtatási feladatainak metaadatait. Igen
PrintJob.Read Olvassa el a nyomtatási feladat metaadatait és hasznos adatait. Lehetővé teszi, hogy az alkalmazás bejelentkezett felhasználó nélkül olvassa be a felhasználók nyomtatási feladatainak metaadatait és hasznos adatait. Igen

OEM nyomtató ügyfélalkalmazás regisztrációja

  1. Több-bérlős alkalmazás létrehozása a vállalat alkalmazásfejlesztési bérlőjével.
  2. Konfigurálja a több-bérlős alkalmazást úgy, hogy a fent meghatározott engedélyhatóköröket kérje le.
    • Printers.Create [Delegált]
    • Printers.Read [Alkalmazás]
    • PrinterProperties.ReadWrite [Alkalmazás]
    • PrintJob.ReadWriteBasic [Alkalmazás]
    • PrintJob.Read [Alkalmazás]

Új alkalmazás regisztrálása

new app registration

completing the registration

A regisztrált alkalmazásazonosító másolása későbbi használatra

save client ID

Alkalmazás-hitelesítési beállítás beállítása

configure app auth setting

A szükséges API-engedélyek hozzáadása az Azure Portallal

add permissions

Miután az "Engedély hozzáadása" gombra kattintott, megjelenik egy úszó panel a jobb oldalon. Az úszó panelen válassza a "Microsoft API-k" lehetőséget.

Microsoft API

Valószínűleg le kell görgetnie az úszó panelen az "Univerzális nyomtatás" kifejezés megtalálásához

Universal Print API

Adja hozzá a fent említett engedélyeket.

Delegated permissions

Application permissions

A szükséges engedélyek hozzáadásakor az alkalmazásengedélyek a következőképpen néznek ki:

API permissions

Ha más módot keres az API-engedélyek konfigurálására, tekintse meg az "Alternatív beállítás" című témakört.

OEM nyomtató ügyfélalkalmazás-közzétevő frissítése

Alapértelmezés szerint a regisztrált alkalmazás "ellenőrizetlen" közzétevővel rendelkezik. Ha változatlan marad, az ügyfelek a "nem ellenőrzött" elemet fogják látni az engedély-hozzájárulás párbeszédpanelen. Kövesse a következőt: Az alkalmazás közzétevőjének tartományának konfigurálása az alkalmazás közzétevőjének beállításához.

A gyors áttekintéshez az alapvető lépések a következők:

application branding page

updated application domain

Megjegyzés:

Miután ez a nyomtatóügyfél-alkalmazásazonosító integrálva van a nyomtatón futó kódba, amikor az azonosítót használó nyomtató először regisztrál az univerzális nyomtatásra egy ügyfélbérlőben, a Rendszergazda istrator kérni fogja az alkalmazás jóváhagyását.

Ha a közzétevő tartománya érvényesített tartományra frissül, az alkalmazásengedély-kérelem hozzájárulási párbeszédpaneljén megjelenik az érvényesített tartomány értéke.

application admin consent

OAuth 2.0-s eszközhitelesítési kérelem minta

A fenti lépések elvégzése után a HTTP POST-kérelem https://login.microsoftonline.com/organizations/oauth2/v2.0/devicecode http törzsszintaxisával történő kiadásával kérheti az ellenőrzést.

  • client_id={registered printer client ID}&scope=https%3A%2F%2Fprint.print.microsoft.com%2F.default
POST https://login.microsoftonline.com/organizations/oauth2/v2.0/devicecode HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: login.microsoftonline.com

client_id=3e41cb36-3180-4566-bf3d-51ec873419e5&scope=https%3A%2F%2Fprint.print.microsoft.com%2F.default

Alternatív lehetőség a szükséges API-engedélyek hozzáadására

app manifest

  1. Szakasz keresése requiredResourceAccess a jegyzékben
  2. Másolja és illessze be a következő szükséges API-engedélyeket a jegyzékbe. A legegyszerűbb módszer a jegyzék teljes requiredResourceAccess szakaszának cseréje.
"requiredResourceAccess": [
    {
        "resourceAppId": "da9b70f6-5323-4ce6-ae5c-88dcc5082966",
        "resourceAccess": [
            {
                "id": "3e306194-d6c5-43ad-afbb-0e7b16a9c10b",
                "type": "Scope"
            },
            {
                "id": "1c90a3a7-465b-49c4-adcc-c8ac83d3d3f8",
                "type": "Role"
            },
            {
                "id": "2b1bdd6b-9a0f-47c6-a806-b3e20cfd07a8",
                "type": "Role"
            },
            {
                "id": "b695614a-52ec-4835-9e13-bdf5ff4c7448",
                "type": "Role"
            },
            {
                "id": "11f87dac-027f-4d76-bd29-1ea1536b93da",
                "type": "Role"
            }
        ]
    }
],
Value Description
Scope Ez az erőforrás-hozzáférés a delegált engedély hatókörének használatára van definiálva.
Szerepkör Ez az erőforrás-hozzáférés az alkalmazásengedély-hatókör használatára van definiálva.
da9b70f6-5323-4ce6-ae5c-88dcc5082966 Az Univerzális nyomtatás azonosítója az Azure globális felhőben.
3e306194-d6c5-43ad-afbb-0e7b16a9c10b A Printers.Create engedély azonosítója.
1c90a3a7-465b-49c4-adcc-c8ac83d3d3f8 A PrinterProperties.ReadWrite engedély azonosítója.
2b1bdd6b-9a0f-47c6-a806-b3e20cfd07a8 A Printers.Read engedély azonosítója.
b695614a-52ec-4835-9e13-bdf5ff4c7448 A PrintJob.Read engedély azonosítója.
11f87dac-027f-4d76-bd29-1ea1536b93da A PrintJob.ReadWriteBasic engedély azonosítója.

add permission scopes to manifest

  • Save the changes.