Document allowed address pair api

Fixes bug: 1229384

Change-Id: I8ae20374b930c74f27b487af3b493b8b7cf3d9c2