मौजूदा डिवाइसों को AMAPI पर माइग्रेट करें

जिन डिवाइसों को आपका कस्टम DPC पहले से मैनेज करता है उन्हें Android डिवाइस पर माइग्रेट किया जा सकता है नीति (एडीपी) और Android Management API का फ़ायदा पाएं.

ज़रूरी शर्तें

• आपका ईएमएम, डिवाइस को पसंद के मुताबिक बनाए गए DPC की मदद से पहले ही मैनेज कर रहा है.
• आपकी पसंद के मुताबिक DPC को AMAPI SDK टूल के साथ इंटिग्रेट किया गया है.
• डिवाइस को Google Play EMM API के साथ रजिस्टर किया गया हो.
• डिवाइस का मालिकाना हक कारोबार के लिए Google Play खाता एंटरप्राइज़ से जुड़ा है.
• डिवाइस Android 9 या इसके बाद वाले वर्शन पर काम करता हो.
• कंपनी के मालिकाना हक वाले डिवाइस पर वर्क प्रोफ़ाइल के मामले में, डिवाइस का चलना ज़रूरी है Android 11 या इसके बाद के वर्शन.

पसंद के मुताबिक बनाए गए DPC में AMAPI SDK टूल के साथ इंटिग्रेट करें

माइग्रेशन प्रक्रिया में AMAPI SDK. इस लाइब्रेरी और इसे जोड़ने के बारे में ज़्यादा जानकारी पाई जा सकती है को अपने ऐप्लिकेशन में लिंक करें. इसके लिए, AMAPI SDK टूल इंटिग्रेशन गाइड पढ़ें.

डिवाइस को माइग्रेट करने का तरीका

1. डिवाइस के माइग्रेट होने के बाद, उसके इस्तेमाल के लिए कोई नीति सेट अप करें को AMAPI से कनेक्ट करना होगा. बेहतरीन उपयोगकर्ता अनुभव के लिए, इसे नीति की तरह ही माना जाना चाहिए आपके DPC के ज़रिए डिवाइस पर पहले से लागू किया जाता है.
2. कॉल करके डिवाइस के लिए माइग्रेशन टोकन बनाएं enterprises.migrationTokens.create.
3. इस माइग्रेशन टोकन के value को भेजें आपका कस्टम DPC शामिल होगा.
4. Play का ईएमएम एपीआई.
5. DpcMigrationClientFactory का इस्तेमाल करके DpcMigrationClient
6. DpcMigrationClient पर, migrateDeviceManagementToAndroidManagementApi तरीका. इससे, माइग्रेशन की प्रक्रिया पूरी हो जाती है.
7. deviceState, ACTIVE में बदल जाएगा और आपको Pub/Sub चैनल से STATUS_REPORT मैसेज.

माइग्रेशन पूरा होने के बाद, कॉल के लिए इस्तेमाल होने वाले ऐप्लिकेशन से डिवाइस के मालिक या प्रोफ़ाइल का ऐक्सेस हट जाता है मालिकाना हक के खास अधिकार, क्योंकि इन्हें Android Device Policy में ट्रांसफ़र किया जाता है.

ध्यान दें: माइग्रेशन शुरू करने के लिए, डिवाइस को इंटरनेट से कनेक्ट करना ज़रूरी है. इस प्रोसेस को इस तरह डिज़ाइन किया गया है कि माइग्रेट करने की प्रक्रिया के लिए किया जाता है, ताकि वे मुख्य काम कर सकें जिनके लिए नेटवर्क कनेक्टिविटी की ज़रूरत है डिवाइस के मालिक या प्रोफ़ाइल के मालिक के अधिकारों के असल ट्रांसफ़र से पहले किए जाते हैं आपके DPC से Android डिवाइस नीति पर कार्रवाई करती है.

माइग्रेशन टोकन

EMM सर्वर इसके उद्देश्य का सिग्नल भेजने के लिए माइग्रेशन टोकन का अनुरोध करता है किसी कस्टम DPC से प्रबंधित होने वाले किसी खास डिवाइस को माइग्रेट करना. माइग्रेशन पूरा होने तक माइग्रेशन टोकन का इस्तेमाल किया जा सकता है या समयसीमा खत्म होने तक इंतज़ार करें.

कस्टम DPC इंटिग्रेशन

सबसे पहले आपको एक DpcMigrationRequest बनाना होगा, जो पास हो रहा है टोकन और ज़रूरी होने पर, कॉन्फ़िगर किए गए वाई-फ़ाई नेटवर्क की सूची बिल्डर:

// Create a DpcMigrationRequest
DpcMigrationRequest request =
        DpcMigrationRequest.builder()
            .setMigrationToken(token)
            .build();

इसके बाद, DpcMigrationClient का इस्तेमाल करके, माइग्रेशन की प्रोसेस migrateDeviceManagementToAndroidManagementApi:

// Create a DpcMigrationClient
DpcMigrationClient dpcMigrationClient = DpcMigrationClientFactory.create(context);
try {
  // Use helper function to retrieve Admin component name
  var adminComponentName = getAdminComponent(context);

  ListenableFuture<DpcMigrationAttempt> futureAttempt =
          dpcMigrationClient.migrateDeviceManagementToAndroidManagementApi(
              new ComponentName(context, DpcMigrationNotificationReceiver.class),
              adminComponentName,
              request);
  // handle futureAttempt
} catch (RuntimeException e) {
  // send failure feedback: "Error: " + e
}

माइग्रेशन की प्रोग्रेस को ट्रैक करना

माइग्रेशन की प्रक्रिया को DpcMigrationAttempt.

आप सीधे उस आईडी का इस्तेमाल कर सकते हैं जिसके ज़रिए वापस किया गया है migrateDeviceManagementToAndroidManagementApi या इसका इस्तेमाल करें getMigrationAttempt और listMigrationAttempts तरीकों का इस्तेमाल करके और माइग्रेशन की कोशिशों की सूची बनाएं.

// Passing an empty name, we retrieve the last attempt 
var request = GetDpcMigrationAttemptRequest.builder().build();

var attempt = client.getMigrationAttempt(request);

आपके पास DpcMigrationListener को सेट अप करने का विकल्प भी होता है. इसके लिए, आपको इनका इस्तेमाल करना होगा: सुनने के लिए, आपका NotificationReceiverService DpcMigrationAttempt के लिए स्थिति के बारे में अपडेट.

// DpcMigrationNotificationReceiver for callback handling
public class DpcMigrationNotificationReceiver extends NotificationReceiverService
    implements DpcMigrationListener {

  @Override
  protected DpcMigrationListener getDpcMigrationListener() {
    // getDpcMigrationListener"
    return this;
  }

  @Override
  public void onMigrationStateChanged(DpcMigrationAttempt migrationAttempt) {
    // send success feedback
  }
}

वाई-फ़ाई नेटवर्क मैनेज करना

अगर वाई-फ़ाई नेटवर्क को कस्टम DPC मैनेज करता है, तो AMAPI ONC नीति AMAPI के लिए इन नेटवर्क के कॉन्फ़िगरेशन से मेल खाना चाहिए, ताकि इन्हें मैनेज किया जा सके बिना किसी रुकावट के. वाई-फ़ाई प्रबंधन के साथ DPC माइग्रेशन का इंटरैक्शन अलग-अलग होता है अलग-अलग तरह के काम कर सकता है.

कंपनी के मालिकाना हक वाले डिवाइसों पर पूरी तरह से मैनेज किए जा रहे डिवाइस और वर्क प्रोफ़ाइल

माइग्रेशन के दौरान, Android Device Policy किसी वाई-फ़ाई नेटवर्क को मानती है नीति में कॉन्फ़िगर किया गया है जिसमें SSID और डिवाइस पर कॉन्फ़िगर किया गया वाई-फ़ाई नेटवर्क, कॉन्फ़िगर किए गए नेटवर्क के मिलान से मेल खाता है वाई-फ़ाई नेटवर्क. इसलिए, कस्टम DPC की मदद से कॉन्फ़िगर किए गए वाई-फ़ाई नेटवर्क पर कोई कार्रवाई नहीं की जाती के बाद माइग्रेशन के बाद की ओएनसी नीति में नेटवर्क. हालांकि, अगर माइग्रेशन के बाद कस्टम DPC को अनइंस्टॉल कर दिया जाता है, तो कस्टम DPC से कॉन्फ़िगर किए गए वाई-फ़ाई नेटवर्क अपने-आप हट जाते हैं. Android Device Policy से जुड़ी नीति को लागू किया जाएगा. साथ ही, अगर इनमें से कोई भी नेटवर्क इस्तेमाल किया जाता है, तो नीति में कॉन्फ़िगर किए जाते हैं, तो नीति में कॉन्फ़िगर किए गए नेटवर्क इस तौर पर जोड़े जाते हैं सामान्य.

निजी डिवाइस पर वर्क प्रोफ़ाइल

तकनीकी वजहों से, कस्टम DPC के ज़रिए कॉन्फ़िगर किए गए वाई-फ़ाई नेटवर्क को ऐसा होना चाहिए इसे Android Device Policy के लिए कस्टम DPC से हटाया गया, ताकि इन्हें मैनेज करना शुरू किया जा सके वाई-फ़ाई नेटवर्क. AMAPI SDK इस बात का ध्यान रखता है और ऐसे वाई-फ़ाई नेटवर्क को हटा देता है मालिकाना हक को कस्टम DPC से Android Device Policy में ट्रांसफ़र करने से पहले हालाँकि, कस्टम DPC को इन नेटवर्क की जानकारी को DpcMigrationRequest. माइग्रेशन के बाद, नेटवर्क नीति में कॉन्फ़िगर किया गया सेक्शन सामान्य रूप से जोड़ा जाएगा, इसलिए हमारा सुझाव है कि कस्टम DPC के ज़रिए जोड़े गए नेटवर्क भी नीति में कॉन्फ़िगर किए जाने चाहिए.

आपको इन बातों के बारे में जानकारी होनी चाहिए:

• अगर चालू नेटवर्क कोई ऐसा वाई-फ़ाई नेटवर्क है जिसे कस्टम DPC ने कॉन्फ़िगर किया है, तो डिवाइस माइग्रेशन के दौरान कुछ देर के लिए ऑफ़लाइन हो सकता है.
• सिर्फ़ कस्टम DPC के ज़रिए कॉन्फ़िगर किए गए वाई-फ़ाई नेटवर्क ही पास किए जाने चाहिए DpcMigrationRequest का इस्तेमाल नहीं किया जाता, तो माइग्रेशन नहीं हो पाता है, अगर: इस नेटवर्क को AMAPI SDK टूल से नहीं हटाया जा सकता (उदाहरण के लिए, उपयोगकर्ता का जोड़ा गया वाई-फ़ाई नेटवर्क).
• वाई-फ़ाई नेटवर्क इस डिवाइस में पास किए जाने चाहिए DpcMigrationRequest सिर्फ़ तब, जब कस्टम DPC प्रोफ़ाइल के मालिक के पास निजी डिवाइस हो, तो माइग्रेशन नहीं हो पाएगा.
• तकनीकी वजहों से, Android 12 एक ऐसा बेहतरीन मामला है जिसमें नेटवर्क DpcMigrationRequest में पास किए गए डिवाइसों को अनदेखा कर दिया जाता है और सभी वाई-फ़ाई कस्टम DPC के ज़रिए कॉन्फ़िगर किए गए नेटवर्क अपने-आप हटा दिए जाते हैं. इसके अलावा, कस्टम DPC के लिए ACCESS_WIFI_STATE होना ज़रूरी है निजी मालिकाना हक वाले डिवाइसों पर वर्क प्रोफ़ाइल के लिए, Android 12 पर अनुमति ऐसा न होने पर, माइग्रेशन नहीं हो पाएगा.

चेतावनियां

यहां इस सुविधा से जुड़ी कुछ चेतावनियां दी गई हैं.

एंटरप्राइज़ से जुड़ा आईडी

Android 12 और उसके बाद के वर्शन पर काम करने वाली वर्क प्रोफ़ाइलों के लिए, एंटरप्राइज़ का आईडी, जिसे DevicePolicyManager.getEnrollmentSpecificId से ऐक्सेस किया जा सकता है माइग्रेशन के समय नहीं बदलता. हालांकि, अगर वर्क प्रोफ़ाइल Android Device Policy से मैनेज किया जाने वाला डेटा, डिवाइस पर फिर से बना दिया जाता है (उदाहरण के लिए पिछले डिवाइस को मिटाने या डिवाइस को फ़ैक्ट्री रीसेट करने के बाद, एंटरप्राइज़ से जुड़ा आईडी बदल जाएगा.

पूरी तरह से मैनेज किए जा रहे डिवाइसों पर वर्क प्रोफ़ाइल

यह सुविधा पूरी तरह से मैनेज किए जा रहे उन डिवाइसों पर काम नहीं करती जिन पर काम करता हो प्रोफ़ाइल में Android 9 या 10 वर्शन होना चाहिए. इन डिवाइसों को माइग्रेट करने की कोशिश नहीं करनी चाहिए, और इस बात पर ध्यान दिए बिना कि क्या कोई गड़बड़ी हुई है, ऐसे डिवाइस काम नहीं करते का इस्तेमाल किया जा सकता है.